Callbacks

Add Multiple Callback Subscriptions

Changed on

Create multiple callback subscriptions in a single request.

This endpoint allows you to create callback subscriptions for multiple event types and callback URLs. Callback subscriptions are identified by the combination of event type and callback URL. If a callback subscription with the same event type and callback URL already exists, it will be included in the response but not created again.

Semantics:

  • Multiple callback subscriptions per event type are now allowed, as long as they have different callback URLs
  • Existing callback subscriptions with matching event type and callback URL are not changed, but included in the response
  • Only the callback subscriptions specified in the request are affected; other existing callback subscriptions remain unchanged
  • At most 42 callback subscriptions per event type are allowed
post/subscriptions/bulk-upsert

Request

Request body

Example request

{
  "subscriptions": [
    {
      "callbackUrl": "https://partner.example.com/send/callback/here"
    }
  ]
}

Response

Ok. Returns the affected subscriptions (both newly created and existing ones that matched).

subscriptionsItems[] required(unresolved $ref)
callbacksEnabledboolean required

Indicates whether callbacks are enabled for the partner

Changes

    • breaking

      the response's body type changed from no type to object for status

    • breaking

      the response's body type changed from no type to object for status

    • breaking

      the response's body type changed from no type to object for status

    • breaking

      the response's body type changed from no type to object for status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status