Tripleseat Webhooks

What are Webhooks?

If you're new to Webhooks, please see this brief overview article on what they are. In short, Webhooks allow a developer to build an integration that listens for triggering actions to occur in Tripleseat, such as when an event is created, updated, or changes status. When the triggering action occurs, a message is sent off to your integration's URL endpoint with all the pertinent details.  

How to Setup a Webhook

Setup is incredibly simple. Under Settings -> Tripleseat API, find the Webhooks section at the bottom. Create a new Webhook, check off the appropriate triggering actions, and provide your integration's URL endpoint. 

What our Webhook Sends

Once triggered, our system will POST a JSON package to your URL endpoint containing the following data:

  • webhook_trigger_type - the triggering action
  • message - the trigger message
  • event OR lead - The affected Lead / Event data payload

Example Payload:

{"webhook_trigger_type"=>"UPDATE_EVENT",
 "message"=>"test event was updated.",
 "event"=>
 {"id"=>999999,
  "name"=>"test event",
  "event_date"=>"3.20.2018",
  "status"=>"TENTATIVE",
  "start_time"=>"3/20/2018 7:00 AM",
  "end_time"=>"3/20/2018 7:00 PM",
  ... [Full Event Payload] ...
 }
}

The full data schemas are available here: for events and leads.

All Webhook Action Trigger Types:

CREATE_EVENT
UPDATE_EVENT
DELETE_EVENT
REASSIGN_EVENT_LOCATION
STATUS_CHANGE_EVENT
CHANGE_EVENT_GUEST_COUNTS
CHANGE_EVENT_DATETIME
REASSIGN_EVENT_OWNERSHIP
REASSIGN_EVENT_CONTACT
REASSIGN_EVENT_ACCOUNT
CREATE_LEAD
CREATE_INTERNAL_LEAD
CONVERT_LEAD

What to do after receiving a Webhook POST

Important: Return a status 200 after successfully receiving a POST from our Webhook service. Failing to do this will result in our system re-sending the same POST several more times (it assumes it has failed without a 200 status response). After enough successive failures, our system will deactivate the Webhook altogether!

 

Need help?

If you're having any problems with getting the above set up working, please do not hesitate to email support with any questions.

Have more questions? Submit a request

Comments