eBay Notifications (Webhooks)
The connector can receive eBay events via webhooks in near real time (Commerce Notification API) — instead of relying on scheduled polling alone. Sales, returns, cancellations and disputes appear in Business Central immediately.
Two pages manage the webhooks:
- eBay Notification Subscriptions — which event topics are subscribed
- eBay Notification Log — which notifications were received and how they were processed
Open the pages
- Via search: eBay Notification Subscriptions or eBay Notification Log
- Via the eBay dashboard → Subscriptions / Notification Log
Subscriptions
| Field |
Description |
| Topic |
The eBay event (e.g. ITEM_SOLD, RETURN_CREATED, CANCELLATION_REQUESTED, PAYMENT_DISPUTE_CREATED). |
| Enabled |
Whether the topic should be subscribed. |
| Registered on eBay |
Whether the subscription is registered with eBay. |
| Last Notification / Notification Count |
Last receipt and total number of received notifications. |
| Action |
Description |
| Initialize Topics |
Creates subscription rows for all available topics. |
| Register Subscriptions |
Registers all enabled topics with eBay. |
| Unregister All |
Removes all subscriptions from eBay. |
Notification log
| Field |
Description |
| Topic / Status |
Event and processing status — green (Processed), red (Failed), grey (Ignored). |
| Received At / Processed At |
Receipt and processing time. |
| Resource ID |
eBay resource (e.g. order ID) the event refers to. |
| Processing Duration (ms) |
Processing duration. |
| Error Message |
Error message if processing failed. |
| Action |
Description |
| Retry |
Reprocesses a failed notification. |
| View Payload |
Shows the received JSON payload. |
| Cleanup (>30 days) |
Deletes processed log entries older than 30 days. |
What do the topics trigger?
| Topic |
Effect |
ITEM_SOLD, ORDER_PAYMENT_COMPLETED |
Immediate import of the order. |
RETURN_CREATED, RETURN_CLOSED |
Fetch of the return request. |
CANCELLATION_REQUESTED |
Fetch of the cancellation request. |
PAYMENT_DISPUTE_CREATED |
Fetch of the payment dispute. |
ITEM_SHIPPED |
Refresh of the order. |
ITEM_LISTING_STATUS_CHANGE |
Status sync of the affected listing. |
Setup
- In the eBay setup, enter the Webhook URL (Azure Function relay that forwards eBay notifications to Business Central) and enable Webhooks Enabled.
- Run Initialize Topics and disable topics you do not need.
- Run Register Subscriptions — the Registered on eBay column confirms registration.
Tips
Webhooks and job queue complement each other
The scheduled job queue synchronisations stay active and act as a safety net — webhooks merely speed up the first fetch. Missed notifications are picked up by the next scheduled run.