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

# Create reward redemption

> Create a reward redemption for a specific reward account.

POST/credit/rewards/accounts/\{token}/redemptions

Create a reward redemption for a specific reward account.

## URL path parameters

| Fields | Description |
| - | - |
| token string  Required | Unique identifier of the reward account. **Allowable Values:**  Existing reward account token |

## Request body

| Fields | Description |
| - | - |
| token string  Optional | Unique identifier of the reward redemption. **Allowable Values:**  36 char max |
| type string  Required | Type of redemption. - `EXTERNAL` - You issue the redemption on your external platform; Marqeta adjusts the reward account balance on the system of record. - `STATEMENT_CREDIT` - Marqeta issues the redemption as a statement credit on the associated account. **NOTE**: This creates a new journal entry on the account and cannot be undone. **Allowable Values:**  `EXTERNAL`, `STATEMENT_CREDIT` |
| amount decimal  Required | Amount of the reward redemption. **Allowable Values:**  0.01 min  Format: 0.00 |
| note string  Optional | Note explaining why the reward is being redeemed. **Allowable Values:**  255 char max |
| destination string  Optional | Destination of the `EXTERNAL` redemption for the brand to track. **Allowable Values:**  255 char max |
| receiving\_account\_token string  Optional | Unique identifier of the external account receiving the reward redemption. This token is the [payment source](https://www.marqeta.com/docs/core-api/credit-account-payment-sources/) token. **Allowable Values:**  36 char max |

## Sample request body

```json JSON lines wrap theme={null}
{
  "type": "EXTERNAL",
  "amount": 1000,
  "destination": "BRAND_WALLET",
  "note": "Redeeming reward balance to Brand Wallet at brand conversion rate 1.5 per point."
}
```

## Response body

| Fields | Description |
| - | - |
| token string  Returned | Unique identifier of the reward redemption. **Allowable Values:**  36 char max |
| type string  Returned | Type of redemption. - `EXTERNAL` - You issue the redemption on your external platform; Marqeta adjusts the reward account balance on the system of record. - `STATEMENT_CREDIT` - Marqeta issues the redemption as a statement credit on the associated account. **NOTE**: This creates a new journal entry on the account and cannot be undone. **Allowable Values:**  `EXTERNAL`, `STATEMENT_CREDIT` |
| destination string  Conditionally returned | Destination of the `EXTERNAL` redemption for the brand to track. **Allowable Values:**  255 char max |
| amount decimal  Returned | Amount to redeem. **Allowable Values:**  Format: 0.00 |
| conversion\_rate decimal  Conditionally returned | Rate that points are worth when converting them using the `REDEMPTION_TYPE` indicated. **Allowable Values:**  0.001 min  Format: 0.000 |
| currency string  Conditionally returned | Type of currency used for the conversion rate. Three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html). **Allowable Values:**  Any currency code allowed by your program |
| note string  Conditionally returned | Note explaining why the reward is being redeemed. **Allowable Values:**  255 char max |
| sor\_reward\_token string  Conditionally returned | Unique identifier of the system of reward (SOR) reward that was created to represent the reward redemption as a `STATEMENT_CREDIT` on a credit account. The SOR entry is a positive amount that is added to the account balance. **Allowable Values:**  36 char max |
| external\_settlement\_date\_time datetime  Conditionally returned | Date and time when the reward redemption was settled on your external platform, in UTC. This field is returned if you handled the reward redemption outside of Marqeta's credit platform. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| receiving\_account\_token string  Conditionally returned | Unique identifier of the external account receiving the reward redemption. This token is the [payment source](https://www.marqeta.com/docs/core-api/payment-sources/) token. **Allowable Values:**  36 char max |
| created\_time datetime  Returned | Date and time when the reward redemption was created on the Marqeta platform, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| updated\_time datetime  Conditionally returned | Date and time when the reward redemption was updated on the Marqeta platform, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |

## Sample response body

```json JSON lines wrap theme={null}
{
  "token": "c21b04ad-37de-4433-890a-3cece8adefc7",
  "type": "EXTERNAL",
  "amount": 1000,
  "conversion_rate": 1.5,
  "destination": "BRAND_WALLET",
  "note": "Redeeming reward balance to Brand Wallet at brand conversion rate 1.5 per point",
  "created_time": "2024-01-05T20:37:11Z"
}
```


## Related topics

- [Reward Redemptions Overview](https://www.marqeta.com/docs/core-api/credit-reward-redemptions.md)
- [Retrieve reward redemption](https://www.marqeta.com/docs/core-api/credit-reward-redemptions/retrieve-reward-redemption.md)
- [List reward redemptions](https://www.marqeta.com/docs/core-api/credit-reward-redemptions/list-reward-redemptions.md)
- [Retrieve reward redemption balance](https://www.marqeta.com/docs/core-api/credit-reward-redemptions/retrieve-balance.md)
- [Create reward entry](https://www.marqeta.com/docs/core-api/credit-reward-accounts/reward-entries/create-entry.md)