Skip to main content
POST
/
v1
/
webhooks
/
configs
Create webhook config
curl --request POST \
  --url https://api.beltic.com/v1/webhooks/configs \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "data": {
    "type": "webhook_config",
    "attributes": {
      "url": "https://example.com/webhooks/documents",
      "subscribed_statuses": [
        "processed",
        "failed"
      ],
      "resource_type": "document"
    }
  }
}
'
{
  "data": {
    "type": "webhook_config",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "attributes": {
      "resource_type": "document",
      "url": "https://example.com/webhooks/documents",
      "subscribed_statuses": [
        "processed",
        "failed"
      ],
      "secret_prefix": "abc12...",
      "is_active": true,
      "created_at": "2026-01-16T10:00:00.000Z",
      "updated_at": "2026-01-16T10:00:00.000Z"
    }
  },
  "meta": {
    "secret": "abc123xyz789..."
  }
}

Authorizations

X-Api-Key
string
header
required

API key for authentication. Access https://console.beltic.com/ to obtain your API key.

Body

application/json
data
object
required

Response

Webhook config created successfully

data
object
required
meta
object
required