Set up manifest webhook
A Manifest Webhook is a tool used particularly in API integrations, to receive real-time updates or notifications whenever specific events occur in the system (such as shipping updates, status changes, and so on). It is commonly used in shipping software to keep track of shipments and their statuses without the need for constant polling or manual checking.
The manifest webhook feature has several purposes:
- Real-time Updates: to receive immediate notifications about shipment activities or status changes, ensuring that the information is up-to-date.
- Automation: to automate the processing of shipping events, reducing manual work and enhances efficiency.
- Integration: to better integration with various services and APIs by providing a mechanism to push data and initiate workflows based on shipping events.
- Error Handling: to notify systems about issues or failures in shipment processing, allowing for timely corrections.
To set up the manifest webhook connection in SAPIENT, follow the instructions as explained in the following procedure.
- On the SAPIENT Home page, in the left navigation panel, select API > Webhooks. In the page that opens, select the Manifest Webhook tab.
Accessing tracking webhook
- In the WEBHOOK DETAILS block of the Tracking Webhook tab, enter the necessary information as described in the following table.
Tip
In the following table, the mandatory fields are marked with an asterisk (*).
| Element | Basic authentication | OAuth2 authentication |
|---|---|---|
| Authentication type* | From the dropdown menu, if applicable, select the Basic authentication type. Basic is a simple authentication type built into the HTTP protocol. It involves sending the user's credentials (username and password) in an encoded format (Base64) within an HTTP header. | From the dropdown menu, if applicable, select the OAuth2 authentication type. oAuth2 is a specific protocol used for authorisation that allows third-party applications to access the user's data without exposing their credentials. |
| Endpoint URL* | Enter your endpoint URL. This is the URL that we use to connect for identification purposes. | ❌ Not applicable |
| Username* | Enter your username to identify and authenticate the INTERSOFT payload. | ❌ Not applicable |
| Password* | Enter the password for the username you entered to identify and authenticate the Intersoft payload. | ❌ Not applicable |
| Token URL* | ❌ Not applicable | Enter your token URL. This is an endpoint we use to connect and get the security token. |
| Client ID* | ❌ Not applicable | Enter your client ID to identify and authenticate the INTERSOFT payload. |
| Secret* | ❌ Not applicable | Enter your secret to identify and authenticate the INTERSOFT payload |
- After entering all the necessary details, select
to check if the setup is configured correctly. Once the test has been completed, and the setup configuration is correct, the webhook is activated and the following success response is displayed:
Success response
Following the success response, a test tracking payload is sent to the webhook as follows:
tracking payload response example
If for some reason, the connectivity test fails, the following message is displayed:
Failed connection response
- After, turn on the Active toggle if you wany to activate the manifest webhook.
Activating manifest webhook
Important
The webhook only works if it is in the Active state. Any changes made to the webhook configuration deactivates it. Therefore, make sure the toggle is set to Active whenever the configuration is updated.
- Select
to confirm the setup completion.
Updated 3 days ago