Notify DocsSave an HTTPS endpoint with a generic, Grok, or Slack payload preset. Pass its whk_ ID as webhookId when creating a prompt, set a service's defaultReplyWebhookId, or set isDefault:true for account replies including MCP/API prompts without services. Account and selected endpoints each receive one event, deduplicated by endpoint ID. Store the signingSecret securely to verify signed deliveries.
Loading API reference…
Required scopes: services:write
bearer services:writeAuthorizationBearer <token>A Notify agent token from notify auth login or the dashboard.
Scope: services:write
application/jsonname*string1 <= length <= 80url*stringurilength <= 2048preset?string"generic""generic""grok""slack"headers?array<>items <= 16[]events?array<>1 <= items <= 3enabled?booleantrueisDefault?booleanfalseSuccess
application/jsonwebhook*signingSecret*stringPlaintext signing secret. Returned only on creation or rotation; store securely.
curl -X POST 'https://example.com/api/agent/webhooks' \ -H 'Content-Type: application/json' \ -d '{ "name": "string", "url": "http://example.com"}'{ "webhook": { "isDefault": true, "id": "string", "name": "string", "url": "http://example.com", "preset": "generic", "headers": [ { "name": "string", "value": "string" } ], "events": [ "interaction.answered" ], "enabled": true, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }, "signingSecret": "string"}