---
title: "Simulate Test Notification"
method: POST
path: "/v2/issuers/{organizationId}/notifications"
tags: ["notifications > Notifications"]
---

# Simulate Test Notification

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

## Request

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

Sends a simulated earned-reward notification to the issuer's configured
webhook for the given event, without requiring a real transaction. Provide
the `userId` and `transactionId` to include in the simulated transaction;
offer information is sourced from an existing offer in sandbox, so the
payload matches a production notification and is HMAC-signed like any other.

A fresh `eventId` is generated on each call, so the triggered notification
is listable and replayable just like a real one. Returns `409` when the
issuer has no enabled subscription for the requested event.

<b>Sandbox environment only.</b> This endpoint is available only in Kard's
test (sandbox) environment. It does not exist in production.<br/>
<b>Required scopes:</b> `notifications:write`

## Path parameters

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

## Request body

- NotificationsNotificationsTriggerNotificationRequestBody
  - `data` NotificationsNotificationsSimulateTestTransactionUnion[], required
    - `type` 'simulateTestTransaction', required: Discriminator value: simulateTestTransaction
    - `attributes` NotificationsNotificationsSimulateTestTransactionAttributes, required
      - `userId` string, required: The issuer's user id (referringPartnerUserId) to attribute the simulated reward to.
      - `transactionId` string, required: The network transaction id to include in the simulated transaction.
      - `eventName` 'earnedRewardApproved' | 'earnedRewardSettled', required: The earned-reward event to simulate. Only these two events are supported.

## Response `202`

Response with status 202

- NotificationsNotificationsTriggerNotificationResponse
  - `data` NotificationsNotificationsTriggerAcceptedNotification, required
    - `eventId` string, uuid, required: The generated event ID of the triggered notification, queued for delivery. It is listable and replayable like any other notification.

## 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

---

[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)