Skip to main content

Allows the creation of a streaming events subscription

POST 
/subscriptions

Creates a subscription to a stream so you can consume its events. If a matching subscription already exists, that subscription is returned instead of creating a duplicate. Use the returned subscription identifier to consume events, commit cursors, query stats, and delete the subscription when you no longer need it. A limit on the total number of subscriptions has been implemented. The default limit is 5 subscriptions. This limit can be increased upon request. Also, a subscription is considered unique based on the combination of the following three fields: "owning_application", "consumer_group" and "event_types". Redundant calls using the exact same values for these fields will not count toward the subscription limit.

Request​

Responses​

Subscription already exists. Returns subscription object that already existed.