Webhooks

These are the steps to setting up your integration with to.co using Webhooks:

Webhooks can be used to send data about to.co events to your server or any other application that can handle HTTP POST calls. to.co lets you set up webhooks to be triggered by different events for example, Org updates or Messages captured by to.co Forms.

Create a Webhook Integration

  1. From the Webhooks page, you can select New Webhook to add a new webhook. If you have set up integrations with other apps, such as Xero, some system webhooks will be created automatically. These can be viewed by changing the filter to show App Webhooks.
  2. Enter your webhook options into the form.

Webhook Events

The following events can be selected to trigger the Webhook:

Event TypeTriggerPayload Model
Contact AddedWhen you add a private Contact to your accountContact
Contact DeletedWhen you delete a private Contact from your accountContact
Contact UpdatedWhen you update a private Contact on your accountContact Updated
Message ReceivedWhen a Message is received for one of your own OrgsMessage
Location AddedWhen a Location is added to an Org you own, watch or are connected toLocation
Location DeletedWhen a Location is deleted from an Org you own, watch or are connected toLocation
Location UpdatedWhen a Location is updated on an Org you own, watch or are connected toLocation Updated
Org ConnectedWhen an Org connection is made with one of your own OrgsOrg
Org DisconnectedWhen an Org disconnects from one of your own OrgsOrg
Org UnwatchedWhen you start watching an OrgOrg
Org UpdatedWhen an Org you own, watch or are connected to is updatedOrg Updated
Org WatchedWhen you stop watching an OrgOrg

Webhook Payloads

When a Webhook is triggered a payload is generated in JSON format (Content-Type of "application/json").