---
title: "Create subscription"
method: POST
path: "/webhooks-api/v2/accounts/{accountUid}/subscriptions"
tags: ["Webhooks"]
---

# Create subscription

`POST /webhooks-api/v2/accounts/{accountUid}/subscriptions`

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/webhooks-api/v2/accounts/{accountUid}/subscriptions`
- Auth: HTTP bearer

Create a new webhook subscription for the specified account.

## Path parameters

- `accountUid` string, required

## Request body

- CreateSubscriptionCommand
  - `subscriptionName` string, required: Display name for the subscription.
  - `subscriptionUrl` string, required: HTTPS endpoint that will receive webhook deliveries.
  - `description` string: Human-readable description.
  - `payloadSecret` string: Secret used to sign webhook deliveries.
  - `requestHeaders` object[]: Custom HTTP headers to include with each delivery.
    - `headerName` string, required
    - `headerValue` string, required
  - `events` object[], required: Event types to subscribe to.
    - `type` string, required
    - `schemaVersion` string, required
  - `projectUids` ProjectUid[]: Optional array of unique project identifiers. If no ids are provided, all projects in the account are included by default.

## Response `200`

Success

- SubscriptionResponse
  - `response` object
    - `data` SubscriptionDTO
      - `subscriptionUid` string
      - `subscriptionName` string
      - `subscriptionUrl` string, uri
      - `accountUid` string
      - `enabled` boolean
      - `userUid` string: Unique identifier of a user — 12 lowercase alphanumeric characters.
      - `description` string
      - `createdDate` string, date-time: ISO 8601 UTC timestamp.
      - `requestHeaders` object[]
        - `headerName` string, required
        - `headerValue` string, required
      - `events` object[]
        - `type` string, required
        - `schemaVersion` string, required
      - `projectUids` ProjectUid[]

## Other responses

- `400`: Provided request parameters are invalid.
- `401`: Authentication failed.
- `429`: Rate limit exceeded.
- `500`: Internal server error.

## Changes

- **2026-10-17** `2cd7a8215799`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/changes/webhooks-api/v2/accounts/:accountUid/subscriptions/post.md)

---

[API](https://skmtc.dev/smartling/apis/smartling-rest-api-reference.md) - [All operations](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/revisions/e63066e7f5e9?raw)