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

# Event: grant.status.updated

POST 

**When is this event triggered?**

This event is triggered when a Cash App Pay grant status has been updated.

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

## Request

### Payload

- `type` (string, required) — The type of event that occurred. `grant.status.updated` for this event.
- `eventId` (string, required) — A unique identifier provided by Cash App for the event.
- `grant` (CashGrant, required) — Describes a grant provided by Cash App.
- `timestamp` (string, required) — When the webhook event was created

## Types

### CashGrant

Describes a grant provided by Cash App.

- `id` (string, required) — Unique identifier for this grant issued by Cash App.
- `intent` (enum, required) — Either ON_FILE or ONE_TIME
  - Allowed values: `ON_FILE`, `ONE_TIME`
- `type` (enum, required) — CASHAPP for all Cash App Pay transactions
  - Allowed values: `CASHAPP`
- `details` (CashGrantDetails, required)

### CashGrantDetails

- `status` (enum, required) — Describes whether or not this grant can be used to perform the action associated with it. If `ACTIVE`, it can be used to perform the action. If `EXPIRED`, it may no longer be used to perform the action due to the current time being past the "expires_at" time. If `CONSUMED`, it was already redeemed to perform the action and cannot be used again. If `REVOKED`, the customer or merchant explicitly unauthorized the grant, preventing it from being used to perform the action.
  - Allowed values: `ACTIVE`, `EXPIRED`, `CONSUMED`, `REVOKED`
- `cashapp` (CashGrantDetailsCashapp, required)
- `createdAt` (string, required) — When this grant was created, in [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339) format (UTC).
- `updatedAt` (string, required) — When this grant was last updated, in [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339) format (UTC).
- `expiresAt` (string, required) — If present, indicates when the grant's status will become EXPIRED, preventing a client from using it to create payments or refunds. The timestamp is in the [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339) format (UTC).

### CashGrantDetailsCashapp

- `customerId` (string, required)
- `cashtag` (string, required) — A publicly-accessible, unique identifier (username) for individuals and businesses using Cash App.