Register a new webhook

Register a new webhook

POST /v1/tenants/{tenant_id}/webhooks/register

cURL

curl --request POST \
  --url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/webhooks/register' \
  --header "x-stateset-api-key: $STATESET_SYNC_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "source": "string",
  "topic": "string",
  "url": "https://example.com/webhooks/stateset"
}'

201

{
  "received": true,
  "webhookId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Path parameters

tenant_id · string · required

Tenant identifier

Request body

object

source · string · required

topic · string · required

url · string

Response

object

received · boolean · required

webhookId · string (uuid)

Status codes

Code	Meaning
201	Webhook registered
400	Invalid request
401	Unauthorized
404	Tenant not found

cURL

curl --request POST \
  --url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/webhooks/register' \
  --header "x-stateset-api-key: $STATESET_SYNC_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "source": "string",
  "topic": "string",
  "url": "https://example.com/webhooks/stateset"
}'

201

{
  "received": true,
  "webhookId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}