Create subscription list

This page describes the Deprecated PCN system. It remains maintained for now but is scheduled removal. For all new implementations, please use the new PCN, documented here: [New] Product Change Notifications API

Endpoint to create new subscription list for product notification.

In order to use the Product change API, please make sure to refer to our guide on how to Sign your API requests to our standard. JWT Signing for Secure API Requests

Create subscription list

post

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

/subscriptions

Header parameters

AuthorizationstringRequired

Token <Your_API_Key>.

Default: Token <Partner_API_key>.

Body

text/plain

namestringOptional

An optional free-form name for the list.

subscription_typestringRequired

Currently only webhook subscription type is supported. There may be different subscription type in the future.

Example: webhook

target_endpointstringRequired

Partner notification URL. Needs to be HTTPS.

Responses

200

Successful operation.

application/json

successbooleanOptional

is_activebooleanOptional

Subscription list status.

idnumberOptional

Unique ID created for this subscription list.

namestringOptional

Name of the list.

subscription_typestringOptional

Currently only webhook subscription type is supported. There may be different subscription type in the future.

target_endpointstringOptional

Partner notification URL.

target_emailstringOptional

Will be supported in the future. Partner email address for the notification.

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

404

Not Found -- Requested resource/endpoint could not be found.

application/json

405

Method Not Allowed -- Check your request method.

application/json

429

Too Many Requests -- We currently apply a fair-use policy, but we might enforce limits in the future.

application/json

500

Internal Server Error -- We had a problem with our server. Try again later.

application/json

503

Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

application/json

post

/subscriptions

HTTPcURLJavaScriptPython

POST /v2/subscriptions HTTP/1.1
Host: api.tiqets.com
Authorization: Token <Partner_API_key>.
Content-Type: text/plain
Accept: */*
Content-Length: 199

"[object Object]"

{
  "success": true,
  "subscription_type": "webhook",
  "is_active": true,
  "name": "Important products",
  "target_endpoint": "https://partner/notification/url",
  "products": [
    {
      "product_id": 973888
    },
    {
      "product_id": 973666
    },
    {
      "product_id": 973698
    }
  ],
  "target_email": null,
  "id": 34
}