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.tiqets.com/v2https://api-tiqt-test.steq.it/v2https://api.api-tiqt-test.steq.it/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

application/json

Request body used to subscribe to product change notifications.

subscription_typestring · enumRequired

Scope of the subscription.

Example: product_idsPossible values:

entity_idsinteger[] · min: 1Optional

Unique identifiers for the entities that belong to the selected subscription scope.

Example: 974081

callback_urlstring · uriRequired

HTTP or HTTPS endpoint where Tiqets will send the product change notifications.

Example: https://example-partner.com/webhooks/product-change

Responses

200

Subscription successfully updated.

application/json

Request body used to subscribe to product change notifications.

subscription_typestring · enumRequired

Scope of the subscription.

Example: product_idsPossible values:

entity_idsinteger[] · min: 1Optional

Unique identifiers for the entities that belong to the selected subscription scope.

Example: 974081

callback_urlstring · uriRequired

HTTP or HTTPS endpoint where Tiqets will send the product change notifications.

Example: https://example-partner.com/webhooks/product-change

subscription_idstringRequired

Unique identifier assigned to the subscription.

statusstring · enumRequired

Current lifecycle status of the subscription.

Possible values:

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.tiqets.com
Authorization: Token <Partner_API_key>.
Content-Type: application/json
Accept: */*
Content-Length: 168

{
  "subscription_type": "product_ids",
  "entity_ids": [
    974081
  ],
  "change_types": [
    "product_details_update"
  ],
  "callback_url": "https://example-partner.com/webhooks/product-change"
}

{
  "subscription_type": "product_ids",
  "entity_ids": [
    974081
  ],
  "change_types": [
    "product_details_update"
  ],
  "callback_url": "https://example-partner.com/webhooks/product-change",
  "subscription_id": "text",
  "status": "pending"
}