Up to 10 per project, coding agents included. A webhook's response has its signing secret. Requires notificationDestination:create and a plan with the type's feature (Discord: integrations, webhook: webhooks, coding agents: agents). Webhooks are refused (400) while they aren't available to the organization yet.
apiKeyAuthorizationBearer <token>An organization API key from the dashboard (Settings → API keys), e.g. Authorization: Bearer annoty_.... x-api-key: annoty_... also works. While the organization has no subscription or trial, every request with a key except GET /v1/organization fails with 402 SUBSCRIPTION_REQUIRED.
projectId*stringapplication/jsonname*string1 <= length <= 100events?array<>The activity events this receives
1 <= items[
"comment.created"
]feedbackSessionIds?array<string>Only these feedback sessions' events, muted or not. Empty: every feedback session in the project that isn't muted. Fixed once created; deleting the last of them deletes the destination
items <= 100[]enabled?booleantruetype*"discord""discord"url*stringDiscord: channel settings → Integrations → Webhooks → Copy Webhook URL
The created notification destination
application/jsonid*stringprojectId*stringfeedbackSessionIds*array<string>The feedback sessions whose events it gets. Empty: every feedback session in the project that isn't muted
type*stringdiscord: a Discord channel's webhook. slack: a channel in a Slack workspace connected with POST /slack/install. webhook: any https URL, signed the Standard Webhooks way. claude_code: a Claude Code scheduled task's API trigger. github_actions: repository_dispatch on a GitHub repository, for Claude Code's or Codex's GitHub Action. cursor: a Cursor cloud agent on a GitHub repository. The last three are coding agents: POST …/comments/{commentId}/send-to-agent sends them a comment
"discord""slack""webhook""claude_code""github_actions""cursor"name*stringurlPreview*stringThe URL without its secret part: Discord's webhook id; a webhook's host, its path's first segment when more follow and the last 4 characters of the rest (n8n.acme.dev/webhook-test/…f3a9); a Claude Code trigger's id or a GitHub repository. The URL and any token are never returned
events*array<>The activity events this receives. Empty for coding agents (claude_code, github_actions): they get only the comments a member sends them
enabled*booleanlastError*|Why the last delivery failed. A webhook deleted on Discord's side also sets enabled to false
lastErrorAt*|date-timehasAnnotyApiKey*booleancursor: an Annoty API key is stored for the agent's MCP server, so it can read the whole comment and reply. Always false for other types
createdAt*stringdate-timesecret*|webhook: the signing secret. Null for every other type
curl -X POST 'https://api.annoty.app/v1/projects/string/notification-destinations' \
-H 'Content-Type: application/json' \
-d '{
"name": "string",
"type": "discord",
"url": "string"
}'{
"id": "string",
"projectId": "string",
"feedbackSessionIds": [
"string"
],
"type": "discord",
"name": "string",
"urlPreview": "string",
"events": [
"comment.created"
],
"enabled": true,
"lastError": "string",
"lastErrorAt": "2019-08-24T14:15:22Z",
"hasAnnotyApiKey": true,
"createdAt": "2019-08-24T14:15:22Z",
"secret": "string"
}