POST
/
integration
/
subscriptions
/
v1
cURL
curl --request POST \
  --url https://api.mottostreaming.com/integration/subscriptions/v1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "project_id": "<string>",
  "name": "<string>",
  "topic_id": "<string>",
  "filter": "<string>",
  "https_url": "<string>",
  "delete_after_use": true
}'
{
  "subscription": {
    "id": "<string>",
    "project_id": "<string>",
    "name": "<string>",
    "topic_id": "<string>",
    "filter": "<string>",
    "https_url": "<string>",
    "delete_after_use": true
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Subscription is used to define which events of the relevant topics should be sent to the callback URL. Limitations:

  1. This is only forward-looking, meaning that only events that occur after the subscription is created will be sent to the target.
  2. There may only be two (2) subscriptions per topic, unless the subscription filter specifies a specific id field OR delete_after_use is set to true.
  3. Delivery is not guaranteed; message delivery will be retried when encountering a non-2xx response, but if there are multiple subscriptions for the same topic and one subscription successfully received the message, it will not be redelivered to the others.

Response

200
application/json

OK

The response is of type object.