Upsert PCN subscription

Create or edit a subscription to receive the updates that are relevant to you.

Read our guideline to use the PCN here: [New] Product Change Notifications API

If you use a new ID, this endpoint will create a new subscription for you, and if you use an ID that exists for your account we will overwrite the existing subscription with the new configuration provided.

Upsert endpoint:

put

https://api-tiqt-test.steq.it/v2https://api.tiqets.com/v2

/product-change-notification/{subscription_id}

Path parameters

subscription_idstringRequired

Unique ID of your subscription.

Header parameters

AuthorizationstringRequired

Token <Your_API_Key>.

Default: Token <Partner_API_key>.

Body

Responses

200

Subscription successfully updated.

application/json

Responseall ofExample: {"subscription_id":"2b4e1f08-c4ef-4a4f-992e-1f7120332c6b","status":"active","subscription_type":"product_ids","entity_ids":[974081],"change_types":["product_details_update"],"callback_url":"https://example-partner.com/webhooks/product-change"}

201

Subscription successfully created.

application/json

400

Bad Request -- Check your request parameters (typo in parameter or invalid value).

application/json

401

Unauthorized -- Your API key is incorrect.

application/json

403

Forbidden -- The endpoint or parameters are not allowed for the matching API key.

application/json

put

/product-change-notification/{subscription_id}

HTTPcURLJavaScriptPython

PUT /v2/product-change-notification/{subscription_id} HTTP/1.1
Host: api-tiqt-test.steq.it
Authorization: Token <Partner_API_key>.
Accept: */*

{
  "subscription_id": "2b4e1f08-c4ef-4a4f-992e-1f7120332c6b",
  "status": "active",
  "subscription_type": "product_ids",
  "entity_ids": [
    974081
  ],
  "change_types": [
    "product_details_update"
  ],
  "callback_url": "https://example-partner.com/webhooks/product-change"
}