---
title: "Create Application Webhook Subscription"
method: POST
path: "/v3/applications/{clientKey}/subscriptions"
tags: ["webhook"]
---

# Create Application Webhook Subscription

`POST /v3/applications/{clientKey}/subscriptions`

Create a webhook subscription at the application level.

`clientKey` can be received upon obtaining client credentials from our tech support.

## Path parameters

- `clientKey` string, required

## Headers

- `X-External-Correlation-Id` string, uuid

## Request body

- SubscriptionRequest
  - `name` string, required — A custom name for your webhook to ease with identification.
  - `trigger_on` string, required — [Choose from a list of available events](/api-reference/webhook-event).
  - `delivery` object, required
    - `version` string, required — The event representation semantic version.
    - `url` string, required — The URL where your server will be listening for events.

## Response `200`

OK

- Subscription
  - `id` string, uuid — UUID that uniquely identifies the subscription.
  - `name` string — A custom name for your webhook to ease with identification.
  - `trigger_on` string — The event type this subscription is listening for. [List of available events](/api-reference/webhook-event).
  - `delivery` object
    - `version` string — The event representation semantic version.
    - `url` string — The URL where your server will be listening for events.
  - `scope` object
    - `domain` string — Scope of this subscription (e.g. "application" or "profile").
    - `id` string — ID associated with the scope (client key or profile ID).
  - `created_by` object
    - `type` string — Creator type (e.g. "application" or "user").
    - `id` string — ID of the creator.
  - `created_at` string, date-time — Timestamp of when the subscription was created.

## Other responses

- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/4907a1d269ab/schema)