Skip to main content
POST
/
webhooks
Create webhook
curl --request POST \
  --url https://api.tickable.io/webhooks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://api.example.com/webhook",
  "event_types": [
    "order.created"
  ],
  "description": "Order notifications"
}
'
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "url": "https://api.example.com/webhook",
  "event_types": [
    "order.created"
  ],
  "description": "Order notifications",
  "created_at": "2024-03-13T12:00:00Z"
}

​
Authentication

✅ Organization User (CustomerEmployee)
❌ Delegated User (EndUser)
✅ Service Account

​
Required Permissions

Webhooks:Create: Always required.

Authorizations

​
Authorization
string
header
required

Pass as Authorization: Bearer {token}. Accepts either an OAuth2 JWT access token or an API key (tk_live_...) created from the Tickable dashboard.

Body

application/json
​
url
string<uri>
required
Example:

"https://api.example.com/webhook"

​
event_types
enum<string>[]
required
Minimum array length: 1
Available options:
order.created,
order.confirmed,
ticket.scanned,
ticket.cancelled
Example:
["order.created"]
​
description
string
Example:

"Order notifications"

Response

200 - application/json

Webhook created

​
id
string<uuid>
required
Example:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

​
url
string
required
Example:

"https://api.example.com/webhook"

​
event_types
enum<string>[]
required
Available options:
order.created,
order.confirmed,
ticket.scanned,
ticket.cancelled
Example:
["order.created"]
​
description
string | null
required
Example:

"Order notifications"

​
created_at
string
required
Example:

"2024-03-13T12:00:00Z"