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.
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
"message"=>"test event was updated.",
"start_time"=>"3/20/2018 7:00 AM",
"end_time"=>"3/20/2018 7:00 PM",
... [Full Event Payload] ...
All Webhook Action Trigger Types:
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!
If you're having any problems with getting the above set up working, please do not hesitate to email support with any questions.