Skip to main content
POST
/
Webhooks
POST /Webhooks
curl --request POST \
  --url https://{base_url}/Webhooks \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "event": "<string>",
  "webhookUrl": "<string>",
  "securityKey": "<string>",
  "securityToken": "<string>"
}
'
Subscribe to a new NowBookIt webhook event. NowBookIt will POST a payload to your webhookUrl when the event occurs.
​
X-API-KEY
string
required
Your API key
​
Content-Type
string
required
Must be application/json
​
event
string
required
Event to subscribe to. Valid values: BOOKING_CREATED, BOOKING_UPDATED, GIFTCARDS_CREATED, GIFTCARDS_UPDATED, GIFTCARDS_CANCELLED, GIFTCARDS_REDEEMED
​
webhookUrl
string
required
Your endpoint URL where NowBookIt will POST the event payload
​
securityKey
string
Auth key sent in the webhook request header
​
securityToken
string
Auth token sent alongside securityKey
curl --location '[BASE_URL]/Webhooks' \
--header 'X-API-KEY: your_api_key_here' \
--header 'Content-Type: application/json' \
--data '{ "event": "BOOKING_CREATED", "webhookUrl": "https://your-system.com/webhooks/nbi/booking-created" }'
Example 200 Response 
{
  "event": "BOOKING_CREATED",
  "webhookUrl": "https://your-system.com/webhooks/nbi/booking-created",
  "locationId": "loc-9",
  "errorMessage": null
}
StatusDescription
200Subscription created
400loggedInAppId
400No Venue Subscribed to your App.
400Giftcard Webhook Request Failed Verification.
400request does not contain a valid Event and/or webhook Url
401X-API-KEY missing or invalid