Webhooks
Receive Chain events in your webhook endpoint
Listen to events in your Chain account on your webhook endpoint so your integration can automatically trigger reactions.
Chain's entire platform is event-based and generates many events on various workflows. Users configure webhooks from the dashboard which provides a user interface for registering and testing your webhook endpoints.
Setup a webhook endpoint
Prerequisites:
- Chain Enterprise
- Chain Admin or Owner role
- Go to the Chain dashboard
- Click your Avatar at the top-right and select Settings
- Click integrations
- Select the event you want to listen to
- Enter the webhook endpoint details or select SFTP if you want to receive a file instead
Once you create an integration, it will automatically be opt-ed in for Developer Logs which you can view under Settings > Logs. If you want to disable these logs, simple click the "Stop publishing to logs" toggle next to the integration.
We recommend to turn off logs for high-volume events like shipmentLocationReceived.
Consumable events:
This list is always changing and we are always adding new events. If you don't see one on here, simply ask your Chain representative and we'll support the new event in a matter of days.
Shipment events:
- shipmentCreated
- shipmentUpdated
- shipmentDeleted
- shipmentStatusChanged
- teamMemberAssignedToShipment
- teamMemberRemovedFromShipment
- driverAssigned
- dispatcherAssigned
- carrierAssigned
- carrierUnassigned
- truckNumberAdded
- truckNumberRemoved
- trailerNumberAdded
- trailerNumberRemoved
Tracking events:
- shipmentLocationReceived
- stopArrived
- stopArrived
- stopETAUpdated
- mobileAppPermissionsChanged
- externalTrackingLinkAdded
- externalTrackingLinkRemoved
Messaging events:
- shipmentChatMessageReceived
- offerChatMessageReceived
Booking events:
- postOfferMade
- postOfferAccepted
- postOfferDeclined
- rateDetailsUpdated (this can be consumed for third-party apps as well such as Greenscreens, FreightWaves Sonar and CargoChief Pricing)