Messaging

Webhooks

Manage webhooks for messaging-specific event topics such as new messages, conversation updates, and participant changes.

List messaging webhooks

GET

/modules/messaging/webhooks

messaging:read

List webhooks filtered to messaging.* topics.

curl

curl https://api.saasignal.saastemly.com/modules/messaging/webhooks \
  -H "Authorization: Bearer sk_live_..."

json — 200 OK

{ "status": "ok" }

Error responses

401 Unauthorized

402 Insufficient tokens

429 Rate limited

Create a messaging webhook

POST

/modules/messaging/webhooks

messaging:write

Register a webhook for messaging event topics.

curl

curl -X POST https://api.saasignal.saastemly.com/modules/messaging/webhooks \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"example","url":"https://app.acme.com/webhooks/saasignal","topics":["kv:write"]}'

json — 201 Created

{ "status": "ok" }

Body field

Type

Description

name required

string

1–128 chars

url required

string (URI)

topics required

array

1–50 items

secret

string

16–256 chars

Error responses

401 Unauthorized

402 Insufficient tokens

429 Rate limited