> This page is for Afterpay.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.cash.app/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.cash.app/_mcp/server.

# Grant status updated

POST 

Webhook notification sent when a grant's status changes

Reference: https://developers.cash.app/afterpay/api-reference/reference/grants-afterpay/grant-status-updated

## Request

### Payload

- `type` (string, required)
- `eventId` (string, required)
- `createdAt` (datetime, required)
- `data` (OnFileGrantStatusUpdatedData, required)

## Types

### OnFileGrantStatusUpdatedData

- `id` (string, required)
- `type` (enum, required)
  - Allowed values: `ON_FILE_GRANT`
- `object` (OnFileGrantStatusUpdatedDataObject, required)

### OnFileGrantStatusUpdatedDataObject

- `grant` (Grant, optional)

### Grant

- `id` (string, required) — Unique id identifying the grant
- `type` (enum, required) — Type of grant
  - Allowed values: `ON_FILE`
- `status` (enum, required) — Current status of the grant
  - Allowed values: `ACTIVE`, `CANCELLED`
- `created` (datetime, required) — Timestamp when the grant was created
- `merchantReference` (string, optional, nullable) — Merchant's reference for this grant
- `cancelled` (datetime, optional) — If present, indicates when the grant was cancelled
- `expires` (datetime, optional) — If present, indicates when the grant's status will become EXPIRED, preventing a client from using it to create payments
- `consumerReference` (string, optional, nullable) — Reference identifier for the consumer
- `email` (string, optional, nullable) — Masked email address of the consumer
- `requestId` (string, optional, nullable) — If present, unique identifier for the request