---
title: "Create subscription list"
method: POST
path: "/subscriptions"
tags: ["Notification Subscriptions API"]
---

# Create subscription list

`POST /subscriptions`

## Headers

- `Authorization` string, required

## Response `200`

Successful operation.

- object
  - `success` boolean
  - `is_active` boolean — Subscription list status.
  - `id` number — Unique ID created for this subscription list.
  - `name` string — Name of the list.
  - `subscription_type` string — Currently only `webhook` subscription type is supported. There may be different subscription type in the future.
  - `target_endpoint` string — Partner notification URL.
  - `products` object[] — List of product ID which will have change notification.
    - `product_id` integer — Tiqets product ID.
  - `target_email` string — Will be supported in the future. Partner email address for the notification.

## Other responses

- `400` — Bad Request -- Check your request parameters (typo in parameter or invalid value).
- `401` — Unauthorized -- Your API key is incorrect.
- `403` — Forbidden -- The endpoint or parameters are not allowed for the matching API key.
- `404` — Not Found -- Requested resource/endpoint could not be found.
- `405` — Method Not Allowed -- Check your request method.
- `429` — Too Many Requests -- We currently apply a fair-use policy, but we might enforce limits in the future.
- `500` — Internal Server Error -- We had a problem with our server. Try again later.
- `503` — Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

---

[API](https://skmtc.net/tiqets/apis/tiqets-distributor-api.md) · [All operations](https://skmtc.net/tiqets/apis/tiqets-distributor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiqets/tiqets-distributor-api/versions/eaf9cf96606a/schema)