v6

latestOpenAPI 3.1.0raw.githubusercontent.com2025-04-245712812.6 KB
Webhooks

Create a webhook

Create a webhook and associated subscriptions.

Required scopes: webhook:read-write.

post/v2/webhooks

Request body

Example request

{
  "data": {
    "target_url": "https://example.com/webhook",
    "subscriptions": [
      {
        "event_type": "note.created"
      }
    ]
  }
}

Response

Success

Example response

{
  "data": {
    "target_url": "https://example.com/webhook",
    "subscriptions": [
      {
        "event_type": "note.created"
      }
    ],
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "webhook_id": "23e42eaf-323a-41da-b5bb-fd67eebda553"
    },
    "status": "active",
    "created_at": "2023-04-27T13:22:49.061281000Z",
    "secret": "ca978112ca1bbdcafac231b39a23dc4da786eff8147c4e72b9807785afee48bb"
  }
}