---
title: "Create Subscription"
method: POST
path: "/subscriptions"
tags: ["subscriptions"]
---

# Create Subscription

`POST /subscriptions`

Creates a new webhook subscription for your company.

You must provide:
- A valid consumer URL where webhook events will be sent
- A technical contact email for notifications about the subscription
- At least one topic name to subscribe to
- An integration type that indicates the purpose of the subscription
Upon successful creation, you'll receive a subscription ID that you can use to manage this subscription.

## Request body

- SubscriptionBodyPost
  - `consumerUrl` string, uri, required — The URL where webhook events will be sent. - Must be a valid, publicly accessible HTTPS URL - Must respond to POST requests - Cannot be changed after subscription creation
  - `techContact` string, email, required — Email address for technical contact. - Used for notifications about subscription status changes - Used for troubleshooting communication - Should be monitored regularly
  - `topicNames` string[], required — A collection of topic names to subscribe to. - Must contain at least one valid topic name - Each topic name must be a string matching an available topic - Use GET /topics to retrieve the list of available topics
  - `integrationType` 'Api' — Type that indicates the purpose of the subscription. If nothing is specified, integration type will be Api by default.

## Response `200`

Ok

- SubscriptionPostResponseOk — Response returned when a subscription is successfully created.
  - `subscriptionId` string, uuid — The unique identifier for the newly created subscription. Use this ID for all future operations on this subscription.

## Other responses

- `400` — Bad Request - The server cannot process the request due to a client error. Common causes: - Invalid request format - Missing required fields - Validation errors in the request data
- `401` — Unauthorized - Authentication is required or has failed. Common causes: - Missing API key - Invalid API key - Expired or deactivated API key
- `412` — Precondition Failed - The request cannot be completed due to failed preconditions. Common causes: - Attempting to update a subscription with invalid topic names - Trying to create a subscription with an invalid URL - Validation errors specific to the operation

---

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