Create subscription.

POST/api/v1/webhooks

Browse API endpoints

Webhooks / CRM REST API

Scope: webhooks:manage

Request body:

Code example

{
  "url": "https://your-server.com/webhooks/seedly",
  "events": [
    "contact.created",
    "message.received",
    "message.sent",
    "message.delivered",
    "message.failed",
    "appointment.booked"
  ],
  "description": "Chatbot integration"
}

Response: Returns the subscription with a signing secret. Store this securely - it is shown once.

Loading endpoint details...

Build a request

Request example

Documented defaults and example values are ready. Change only the parameters you need.

Connection

Your CRM deployment URL

Replace the Bearer API key placeholder in the copied server-side code. No API key is entered or sent here.

Sub-account ID Agency keys onlyAgency-scoped keys require the X-Sub-Account-Id header.

Body parameters

url Required

events Required

description

Edit the full JSON body

cURL

curl --request POST \
  --url 'https://your-crm.example.com/api/v1/webhooks' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{"url":"https://your-server.com/webhooks/seedly","events":["contact.created","message.received","message.sent","message.delivered","message.failed","appointment.booked"],"description":"Chatbot integration"}'

This shows a static response from the documentation. It does not send a request to your CRM or use an API key.