API ReferenceWebhooks

Create webhook subscription

Markdown
POST/api/v3/webhook_subscriptions

Creates a webhook subscription for the authenticated project. Only one subscription is allowed per project. The signing secret is returned only on creation.

Authorization

ApiKeyAuth
x-api-key<token>

API key authentication

In: header

Request Body

application/json

webhook_urlstringRequired

HTTPS URL to receive webhook events

Format: uri
enabled_eventsarray of stringRequired

Array of event types to subscribe to

versionenum

Webhook payload version

Default: "V3"
Possible values:
V1V2V3

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://backend.composio.dev/api/v3/webhook_subscriptions" \  -H "Content-Type: application/json" \  -d '{    "webhook_url": "http://example.com",    "enabled_events": [      "string"    ]  }'
{
  "id": "string",
  "webhook_url": "string",
  "version": "V1",
  "enabled_events": [
    "string"
  ],
  "secret": "string",
  "created_at": "string",
  "updated_at": "string"
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}