How do I use my own unique identifier for a subscription?

In the Bango Subscriptions API, every subscription has a globally unique identifier. This is allocated by Bango on creation, and does not change. You might want to associate your own unique internal identifier with a subscription: for example, to link your own private internal data to the subscription.

To use your own identifier:

• When you create the subscription, pass your internal unique identifier as the externalKey parameter in the request body
• You can fetch the subscription either using the subscription ID assigned by Bango (GET /subscription/{subscriptionId}) or your internal unique identifier GET /subscription/externalKey/{externalKey}

You may not use the same externalKey with more than one subscription. If you create a subscription and supply anexternalKey already in use, the Bango Subscriptions API returns an HTTP 409 Conflict response.