---
title: "Create Subscription"
method: POST
path: "/v2/issuers/{organizationId}/subscriptions"
tags: ["notifications > Subscriptions"]
---

# Create Subscription

`POST /v2/issuers/{organizationId}/subscriptions`

## Request

- Base URL: `https://rewards-api.getkard.com`
- URL: `https://rewards-api.getkard.com/v2/issuers/{organizationId}/subscriptions`
- Auth: HTTP bearer

Call this endpoint to subscribe to notification events.<br/>
<b>Required scopes:</b> `notifications:write`

## Path parameters

- `organizationId` string, required: Your issuer organization ID, provided by Kard

## Request body

- NotificationsSubscriptionsSubscriptionRequestBody
  - `data` NotificationsSubscriptionsSubscriptionRequestUnion[], required
    - `type` 'subscription', required: Discriminator value: subscription
    - `attributes` NotificationsSubscriptionsSubscriptionRequestAttributes, required
      - `eventName` 'earnedRewardApproved' | 'earnedRewardSettled' | 'earnedRewardRejected' | 'auditUpdate' | 'fileProcessingResult' | 'pushNotificationPlacementFile' | 'emailNotificationPlacementFile' | 'payoutReconciliationFile', required
      - `webhookUrl` string, required: The URL where notifications will be delivered
      - `enabled` boolean, required: Indicates whether the subscription is active

## Response `201`

Response with status 201

- NotificationsSubscriptionsCreateSubscriptionsResponseObject
  - `data` NotificationsSubscriptionsCreateSubscriptionUnion[], required
    - `type` 'subscription', required: Discriminator value: subscription
    - `attributes` NotificationsSubscriptionsSubscriptionRequestAttributes, required
      - `eventName` 'earnedRewardApproved' | 'earnedRewardSettled' | 'earnedRewardRejected' | 'auditUpdate' | 'fileProcessingResult' | 'pushNotificationPlacementFile' | 'emailNotificationPlacementFile' | 'payoutReconciliationFile', required
      - `webhookUrl` string, required: The URL where notifications will be delivered
      - `enabled` boolean, required: Indicates whether the subscription is active
    - `id` string, required: The ID of the subscription

## Other responses

- `400`: Error response with status 400
- `401`: Error response with status 401
- `409`: Error response with status 409
- `429`: The issuer's traffic grew faster than its allowed rate, or the endpoint's own limit was reached. If the response includes a `Retry-After` header, wait that many seconds before retrying. See [Rate Limits](/2024-10-01/api/integration-guides/rate-limits).
- `500`: Error response with status 500

## Changes

- **2026-10-22** `4e87fc8b018b`: 1 info
  - added the non-success response with the status `429`
- **2026-10-19** `a664c5d23771`: 1 warning, 1 info
  - added the new `payoutReconciliationFile` enum value to the `data/items/oneOf[subschema #1]/attributes/eventName` response property for the response status `201`
  - added the new `payoutReconciliationFile` enum value to the request property `data/items/oneOf[subschema #1]/attributes/eventName`

[Operation history](https://skmtc.dev/getkard/apis/getkard-2/changes/v2/issuers/:organizationId/subscriptions/post.md)

---

[API](https://skmtc.dev/getkard/apis/getkard-2.md) - [All operations](https://skmtc.dev/getkard/apis/getkard-2/llms.txt) - [OpenAPI document](https://skmtc.dev/getkard/apis/getkard-2/revisions/bd47764afa21?raw)