Authentication

Authentication for the Streaming API V2 is unchanged from V1: create an API consumer with the Manage Events Streaming (MANAGE_EVENTS_STREAMING) permission assigned to it, create API keys using this API consumer, and authenticate every request with an API key in the request header. The same API keys your integration already uses with Streaming API V1 work with V2 as well.

You may create and manage API consumers and keys either through the Mambu UI or using the API Consumers endpoint provided by Mambu API v2. For more information, see API Consumers in our User Guide.

Required on every request

Every request to the Streaming API V2 must include the Accept: application/vnd.mambu.v2+json header. Without it, the request is treated as a V1 request.

Example authenticated request using cURL

curl --request GET 'https://TENANT_NAME.mambu.com/api/subscriptions/d45a34ed341321bca4d89e42452dc074/events' \
  --header 'Accept: application/vnd.mambu.v2+json' \
  --header 'apikey: i9TCzwUBwyTVQrfPEAhk0oEpOUCt0O2M'