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

# Update Subscription

`PATCH /v2/issuers/{organizationId}/subscriptions/{subscriptionId}`

## Request

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

Call this endpoint to update existing notification subscriptions.<br/>
<b>Required scopes:</b> `notifications:write`

## Path parameters

- `organizationId` string, required: Your issuer organization ID, provided by Kard
- `subscriptionId` string, required: The ID of the subscription

## Request body

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

## Response `200`

Response with status 200

- NotificationsSubscriptionsUpdateSubscriptionsResponseObject
  - `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
- `404`: Error response with status 404
- `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/oneOf[subschema #1]/attributes/eventName` response property for the response status `200`
  - added the new `payoutReconciliationFile` enum value to the request property `data/oneOf[subschema #1]/attributes/eventName`

[Operation history](https://skmtc.dev/getkard/apis/getkard-2/changes/v2/issuers/:organizationId/subscriptions/:subscriptionId/patch.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)