> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.nowbookit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gift Cards

> Push gift card activity events from your system to NowBookIt. Custom-built per partner during onboarding.

## Inbound gift card webhook events

Use this endpoint to push gift card activity events from your system to NowBookIt. NowBookIt processes the event and calls redeem or cancel on the relevant gift card.

<Warning>
  **This endpoint requires a custom implementation per partner.** NowBookIt builds a handler specific to your system's event format and activity types during onboarding. Contact your NowBookIt partner manager to enable this for your integration.
</Warning>

***

## POST `GiftCards/partners/{partnerName}/events/{eventType}`

Push a gift card activity event to NowBookIt.

**Path parameters**

| Parameter     | Description                                                                 |
| ------------- | --------------------------------------------------------------------------- |
| `partnerName` | Your registered partner identifier                                          |
| `eventType`   | The event type as defined by your system (e.g. `gift_card_activity.create`) |

**Request body**

Your system's native payload — the structure is agreed with NowBookIt during onboarding. NowBookIt's partner-specific handler transforms your payload into a `GiftCardEventPayload` and validates it before processing.

At minimum the payload must allow NowBookIt to identify:

* The venue (`locationId` or equivalent field)
* The gift card number
* The activity type (redeem, deactivate, etc.)
* The amount, if applicable

**Processing behaviour**

NowBookIt validates the request signature via `PartnerRequestValidationFilter` before any processing occurs. After that:

1. The partner handler transforms your payload into a `GiftCardEventPayload`
2. If the payload is invalid or the activity type is unrecognised, NowBookIt logs a warning and returns `200` — no action is taken
3. NowBookIt resolves the venue from the `locationId` in the payload
4. If gift card integration is not enabled for the venue, NowBookIt returns `200` silently
5. The event is processed — NowBookIt calls redeem or cancel on the gift card depending on activity type
6. Always returns `200 OK` regardless of outcome

**Responses**

| Status | Description                                                 |
| ------ | ----------------------------------------------------------- |
| `200`  | Event received — all outcomes including errors return `200` |
| `400`  | Partner not found, or signature invalid/missing             |