webhooks_create
webhooks_create
Section titled “webhooks_create”Category: webhooks
Create a new webhook attached to a channel.
When to use
Section titled “When to use”- Provision an automation endpoint (CI notifier, alert relay, cross-poster).
When NOT to use
Section titled “When NOT to use”- Sending one-off bot messages →
messages_send.
| Field | Type | Required | Description |
|---|---|---|---|
channel_id | string | yes | Channel that will host the webhook |
name | string | yes | Webhook display name (max 80 chars) |
avatar | unknown | no | base64-encoded image data URI for the webhook avatar, or null |
audit_reason | string | no | Reason recorded in audit log (X-Audit-Log-Reason header) |
Returns
Section titled “Returns”Full webhook record INCLUDING the token — store it as a secret. The agent needs the token to call webhooks_execute. name is wrapped untrusted (creator-controlled).
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | Discord webhook ID |
type | integer | yes | |
channel_id | unknown | yes | |
application_id | unknown | yes | |
name | unknown | yes | |
avatar | unknown | yes | |
token | string | no | Discord webhook token (secret — treat as credential, do not log) |
untrusted_name | string | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | no |
| Idempotent | no |
| Open-world | yes |
| Confirmation required | no |