Notification API
Subscribe to ABC Supply updates such as order and shipment status. The Notification API allows you to configure webhooks and let ABC Supply push updates to your system in real time.
The ABC API Notification endpoints are now available.
The Update Webhook endpoint updates the configuration of a webhook that has been previously registered. The request must include the configuration parameters to be updated, such as name, data format, event type, URL, etc. The endpoint response includes the webhook id, name, status, and a link to the webhook registration request.
Notification API
Update Webhook
PATCH /webhooks/{webhookId}
Update an existing webhook configuration
Sandbox
Production
Authorization
OAuth 2.0 server or user token with the notification.write scope.
Request
Name
Type
Description
type
enum
The type of registration (e.g., “order:). Order is the only webhook supported at this time.
events
array
The webhook events list of the returned webhook (e.g., “ORDER_UPDATE”).
url
string
The URL of the webhook being registered.This is the URL that will be invoked when order statuses change.
Example Request
URI Parameters
The unique identifier {webhookId} representing a specific webhook.
PATCH /api/notification/v2/webhooks HTTP/1.1
Host: partner.abcsupply.com
Authorization: Bearer <TOKEN>
{
"type": "order",
"events": [
"ORDER_UPDATE" ],
"url": "https://abcpartner.com/webhook/events/orders"
}Response
Example Response
{
"id": "cf38e653-29c8-4b0a-8f68-a64018195da9",
"secret": "ZGMyMjNmNTQtYjhlYS00YWJmLWFlYWQtYjczYmZjODk4NDQ5LTIwMjQtMDYtMTFUMTk6MjI6MDIuMTcxWi02MTA2MDU=",
"status": "UNREGISTERED",
"links": {
"self": "https://partner.abcsupply.com/api/notification/v2/webhooks/cf38e653-29c8-4b0a-8f68-a64018195da9"
}
}Name
Type
Description
id
string
The ID of the generated webhook registration.
status
string
The status of the registration attempt.
link
object
The object containing the URL information for the registration request.
link.self
string
The reference URL to the registration request.
secret
string
A base 64 encoded secret value that will be used to identify requests coming from ABC as a form of authentication.
HTTP Status Codes
Name
Type
Description
400
Bad Request
Check the Request to make sure the Request Body and Parameters are passed correctly based on the API documentation.
404
Object Not Found
The request returned empty or no object. Please check the object identifier.