Skip to main content
POST
Create webhook

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:
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:
description
string | null
required
Example:

"Order notifications"

created_at
string
required
Example:

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

secret
string
required

Signing secret for verifying deliveries. Only returned when the webhook is created, so store it now.

Example:

"whsec_5f0c8a3e9b2d4c6f8a1e3b5d7c9f0a2b4d6e8f1a3c5e7b9d"