Skip to main content
POST
/
api
/
webhooks
/
Create a Webhook
curl --request POST \
  --url https://api.trysela.com/api/webhooks/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "filter_condition": "<string>",
  "headers": "<unknown>"
}
'
{
  "id": 123,
  "url": "<string>",
  "filter_condition": "<string>"
}

Authorizations

​
Authorization
string
header
required

Token-based authentication with required prefix "Token"

Body

​
url
string<uri>
required

Webhook URL. Supports {{variable}} placeholders resolved from the webhook payload (e.g. https://api.example.com/leads/{{id}}/notify). Use dot notation for nested values (e.g. {{metadata.us_state}}).

Required string length: 1 - 255
​
trigger
enum<string>
  • LEAD_CREATED - Lead Created
  • LEAD_UPDATED - Lead Updated
  • LEAD_CLOSED - Lead Closed
  • LEAD_CLOSED_INCOMPLETE - Lead Closed Incomplete
  • LEAD_LOST - Lead Lost
  • LEAD_SCHEDULE_COMPLETED - Lead Schedule Completed
  • LEAD_LATE_CALLBACK - Lead Late Callback
  • LEAD_OUT_OF_TERRITORY - Lead Out of Territory
  • LEAD_BAD_NUMBER - Lead Bad Number
  • LEAD_CANCELLED - Lead Cancelled
  • LEAD_CALLBACK_TO_TRANSFER - Lead Callback to Transfer
  • LEAD_BEFORE_REENGAGEMENT - Lead Before Reengagement
  • LEAD_REENGAGEMENT - Lead Reengagement
  • LEAD_FIRST_INBOUND - Lead First Inbound
  • CALL_COMPLETE - Call Complete
  • BEFORE_CALLING - Before Calling
  • CALL_FAILED - Call Failed
  • CALL_ENDED - Call Ended
  • CALL_TRANSFER_INITIATED - Call Transfer Initiated
  • SMS_DNC - SMS DNC
  • CALL_DNC - CALL DNC
Available options:
LEAD_CREATED,
LEAD_UPDATED,
LEAD_CLOSED,
LEAD_CLOSED_INCOMPLETE,
LEAD_LOST,
LEAD_SCHEDULE_COMPLETED,
LEAD_LATE_CALLBACK,
LEAD_OUT_OF_TERRITORY,
LEAD_BAD_NUMBER,
LEAD_CANCELLED,
LEAD_CALLBACK_TO_TRANSFER,
LEAD_BEFORE_REENGAGEMENT,
LEAD_REENGAGEMENT,
LEAD_FIRST_INBOUND,
CALL_COMPLETE,
BEFORE_CALLING,
CALL_FAILED,
CALL_ENDED,
CALL_TRANSFER_INITIATED,
SMS_DNC,
CALL_DNC
​
method

HTTP method to use when sending the webhook request. NULL or blank defaults to POST.

  • GET - GET
  • POST - POST
  • PUT - PUT
  • PATCH - PATCH
Available options:
GET,
POST,
PUT,
PATCH
​
filter_condition
string | null

Optional filter expression that controls when the webhook fires. The expression is evaluated against the webhook payload - the same data sent in the request body. Leave blank to always fire. Use has('field') to check whether a field exists, get('path.to.value', default) for safe nested access, and comparison operators such as ==, !=, and, or. Examples: status == 'CLOSED', has('last_chat') and last_chat['is_contact'], get('last_chat.call_direction', '') == 'INBOUND'

​
headers
any

Response

201 - application/json
​
id
integer
required
read-only
​
url
string<uri>
required

Webhook URL. Supports {{variable}} placeholders resolved from the webhook payload (e.g. https://api.example.com/leads/{{id}}/notify). Use dot notation for nested values (e.g. {{metadata.us_state}}).

Maximum string length: 255
​
trigger
enum<string>
  • LEAD_CREATED - Lead Created
  • LEAD_UPDATED - Lead Updated
  • LEAD_CLOSED - Lead Closed
  • LEAD_CLOSED_INCOMPLETE - Lead Closed Incomplete
  • LEAD_LOST - Lead Lost
  • LEAD_SCHEDULE_COMPLETED - Lead Schedule Completed
  • LEAD_LATE_CALLBACK - Lead Late Callback
  • LEAD_OUT_OF_TERRITORY - Lead Out of Territory
  • LEAD_BAD_NUMBER - Lead Bad Number
  • LEAD_CANCELLED - Lead Cancelled
  • LEAD_CALLBACK_TO_TRANSFER - Lead Callback to Transfer
  • LEAD_BEFORE_REENGAGEMENT - Lead Before Reengagement
  • LEAD_REENGAGEMENT - Lead Reengagement
  • LEAD_FIRST_INBOUND - Lead First Inbound
  • CALL_COMPLETE - Call Complete
  • BEFORE_CALLING - Before Calling
  • CALL_FAILED - Call Failed
  • CALL_ENDED - Call Ended
  • CALL_TRANSFER_INITIATED - Call Transfer Initiated
  • SMS_DNC - SMS DNC
  • CALL_DNC - CALL DNC
Available options:
LEAD_CREATED,
LEAD_UPDATED,
LEAD_CLOSED,
LEAD_CLOSED_INCOMPLETE,
LEAD_LOST,
LEAD_SCHEDULE_COMPLETED,
LEAD_LATE_CALLBACK,
LEAD_OUT_OF_TERRITORY,
LEAD_BAD_NUMBER,
LEAD_CANCELLED,
LEAD_CALLBACK_TO_TRANSFER,
LEAD_BEFORE_REENGAGEMENT,
LEAD_REENGAGEMENT,
LEAD_FIRST_INBOUND,
CALL_COMPLETE,
BEFORE_CALLING,
CALL_FAILED,
CALL_ENDED,
CALL_TRANSFER_INITIATED,
SMS_DNC,
CALL_DNC
​
method

HTTP method to use when sending the webhook request. NULL or blank defaults to POST.

  • GET - GET
  • POST - POST
  • PUT - PUT
  • PATCH - PATCH
Available options:
GET,
POST,
PUT,
PATCH
​
filter_condition
string | null

Optional filter expression that controls when the webhook fires. The expression is evaluated against the webhook payload - the same data sent in the request body. Leave blank to always fire. Use has('field') to check whether a field exists, get('path.to.value', default) for safe nested access, and comparison operators such as ==, !=, and, or. Examples: status == 'CLOSED', has('last_chat') and last_chat['is_contact'], get('last_chat.call_direction', '') == 'INBOUND'