What are DataDoe Webhooks?

DataDoe Webhooks let your systems receive HTTPS callbacks when selected events happen for your Sellers and Vendors. Instead of polling DataDoe or the Selling Partner API (SP API) for changes, DataDoe POSTs a JSON payload to an endpoint you control as soon as matching events are ready.

Use Webhooks to trigger automations, sync Amazon events into your enterprise resource planning (ERP) or warehouse management system (WMS), or wake up downstream jobs when new notification data becomes available.

How do I set up a webhook?

1. Open Integrations > Webhooks (opens in a new tab) in DataDoe.
2. Click New webhook and fill in:
   • Name — a label you recognize later
   • Target URL — your HTTPS endpoint that accepts POST requests
   • Message types — which events to subscribe to
   • Sellers and Vendors — which DataDoe accounts should be included
   • Secret header (optional) — a custom header name and value DataDoe sends on every delivery so you can verify requests
3. Save the subscription. It starts in the Active state.

You can create multiple subscriptions per Organization, for example one endpoint for your ERP and another for an internal queue. When a single event matches more than one active subscription, DataDoe delivers it to each matching subscription separately.

Which message types are available?

What does DataDoe send to my endpoint?

DataDoe sends an HTTPS POST with Content-Type: application/json. The body has this shape:

1{
2    "deliveryId": "550e8400-e29b-41d4-a716-446655440000",
3    "organizationId": "11111111-1111-4111-8111-111111111111",
4    "webhookId": "33333333-3333-4333-8333-333333333333",
5    "messages": [
6        {
7            "organizationId": "11111111-1111-4111-8111-111111111111",
8            "sellerOrVendorId": "22222222-2222-4222-8222-222222222222",
9            "messageId": "44444444-4444-4444-8444-444444444444",
10            "messageType": "AMAZON_ORDER_UPDATE",
11            "messageSummary": {},
12            "messageData": {}
13        }
14    ]
15}

Each body field is described below:

Detailed webhook message schemas are in the interactive Webhooks Messages Schemas page.

The 15 SP-API notification message types share a stable contract. Their messageSummary always includes marketplaceId, sellerOrVendorId, spApiNotificationId, spApiNotificationType, and eventTimeUtc. It can also include marketplaceCountryCode, marketplaceCountryName, sellerOrVendorName, and marketplaceSellerId. Their messageData includes the Amazon notificationMetadata and the payload routed to the selected Seller or Vendor connection. The two order message types retain their order-specific schemas.

If you configured a secret header, DataDoe includes it on every request using the header name you chose.

What should my endpoint return?

Return any 2xx HTTP status to acknowledge successful processing. Non-2xx responses or network errors are treated as delivery failures.

What happens when a delivery fails?

If your endpoint returns a non-2xx status or the request cannot be completed, DataDoe:

1. Pauses the subscription automatically.
2. Emails Organization members.

After you fix the endpoint, open Integrations > Webhooks (opens in a new tab) and select Resume.

If you believe an invalid delivery is an error on DataDoe's side, please use the contact form (opens in a new tab).

What are the target URL requirements?

Target URLs must:

• use HTTPS
• use a domain name (not a raw IP address)
• not use localhost or *.localhost
• accept POST requests

How is this related to real-time data?

Webhooks complement DataDoe's scheduled and real-time data pipelines described in Data Fetch Periods. Webhooks are the recommended way to get real-time data updates.

Where can I get help?

Use the contact form (opens in a new tab).