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

# Create Subscription

`POST /subscriptions`

## Request

- Base URL: `https://api.acculynx.com/webhooks/v2`
- URL: `https://api.acculynx.com/webhooks/v2/subscriptions`
- Auth: HTTP bearer

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.dev/acculynx/apis/webhooks-api.md) - [All operations](https://skmtc.dev/acculynx/apis/webhooks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/acculynx/apis/webhooks-api/revisions/8bc7679859d8?raw)