Create Tracking Webhook
Set up the tracking webhook connection
To set up the webhook please log onto the system and in the Main Menu navigate to API > Tracking > Tracking Webhook.
Configuration steps:
- Add the Endpoint URL you want us to send the tracking updates to. Use an HTTPS endpoint to ensure a secure way of sending the data.
- Define the authentication method that your system will use to authenticate the tracking webhook API calls
- OAuth2 authentication
- Token URL - this is an endpoint we connect to, to get the security token
- Client ID, and Secret to identify and authenticate the Intersoft payload
- Basic authentication
- Endpoint URL - this is an endpoint we connect to, to identify
- Username and password to identify and authenticate the Intersoft payload
- OAuth2 authentication
- Test the webhook connection to ensure the setup is correct.
Only when a successful response is returned will the webhook be activated. If the connection test fails, please check that the details entered are correct.
Successful connection response:
![](https://files.readme.io/0994fa6-image.png)
Failed connection response (example):
![](https://files.readme.io/65a4983-image.png)
If the connection is successful, a test tracking payload is sent to the webhook. Please see the example of the test payload below:
![](https://files.readme.io/6b06c9d-image.png)
- Select from the dropdown to receive either Milestones or Full Tracking Events
Milestones are key events that occur in the delivery journey, such as the shipment being received by the carrier, going out for delivery, being delivered successfully etc.
You can choose whether you want to receive tracking milestones OR full tracking events. You are able to choose only one option.
- If you select to receive milestones only, we will only push tracking, when a new milestone is triggered.
- If you select to receive full tracking events, we will push tracking every time we receive a new tracking event from the carrier, whether that tracking event triggers a new milestone or not.
A list of milestones and full tracking events can be found here.
- Change the 'Active' toggle into the active stage if you are ready to activate the tracking webhook.
![](https://files.readme.io/a76feb6-image.png)
IMPORTANT
The webhook will only work if it is set to 'Active'. Please note that any changes to the webhook configuration will deactivate it, so ensure the toggle is set to 'Active' once you are happy with the changes.
- Save the changes to confirm the setup is completed.
Updated 4 months ago