Registers a new callback to receive event notifications. Verify your callback before you can use it in a subscription.
|callbackName||string||Required||Name of the callback.|
|url||string||Required||HTTPS URL of the customer callback that receives event notifications in the format |
|maxBatchSize||integer||Maximum number of events that this callback can receive in a single call. Must be at least 100 and no more than 1,000. Default is 1,000.|
Your URL endpoint must be online and reachable before you create a callback. The Event Notification Service immediately attempts to post verification details to the endpoint.
If your callback doesn’t respond within 30 seconds or returns a non-200 HTTP status, the callback creation fails with a 400 HTTP status and the reason for the failure similar to the following.
|201 Created||Callback created. Review example response.|
|304 No Change||Callback already exists on the server.|
|400 Bad Request||Unable to process the request.|
|403 Forbidden||Failed to pass authorization.|
|500 Server Error||Internal error|