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

> Create an adjustment for an existing credit account.

POST/credit/accounts/\{account\_token}/adjustments

Create an adjustment for an existing credit account.

## URL path parameters

| Fields | Description |
| - | - |
| account\_token string  Required | Unique identifier of the credit account for which you want to create an adjustment. Send a `GET` request to `/credit/accounts` to retrieve existing credit account tokens. **Allowable Values:**  Existing account token |

## Request body

| Fields | Description |
| - | - |
| token string  Optional | Unique identifier of the adjustment. **Allowable Values:**  36 char max |
| original\_ledger\_entry\_token uuid  Optional | Unique identifier of the original journal entry needing the adjustment. Required when adjusting an existing journal entry. **Allowable Values:**  Existing journal entry token |
| external\_adjustment\_id uuid  Optional | Unique identifier you provide of an associated external adjustment that exists outside Marqeta's credit platform. **Allowable Values:**  255 char max |
| amount decimal  Required | Amount of the adjustment. Value must be negative if `original_ledger_entry_token` is not passed. **Allowable Values:**  1000000 max |
| currency\_code string  Required | Valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html). **Allowable Values:**  `USD` |
| description string  Required | Description of the adjustment. **Allowable Values:**  1–255 chars |
| note string  Optional | Additional information on the adjustment. **Allowable Values:**  255 char max |
| reason string  Optional | Reason for the adjustment. - `DISPUTE` - The adjustment occurred because a dispute was initiated. - `DISPUTE_RESOLUTION` - The adjustment occurred because of the result of a dispute resolution. - `RETURNED_OR_CANCELED_PAYMENT` - The adjustment occurred because a payment was returned or canceled. - `OTHER` - Any other reason the adjustment occurred. For example, a waived fee or account write-off. **Allowable Values:**  `DISPUTE`, `DISPUTE_RESOLUTION`, `RETURNED_OR_CANCELED_PAYMENT`, `OTHER` |

## Sample request body

```json JSON lines wrap theme={null}
{
  "original_ledger_entry_token": "2384f927-e4fe-47af-8ff6-0712ee41a2eb",
  "amount": -25,
  "currency_code": "USD",
  "description": "Waived late payment fee"
}
```

## Response body

| Fields | Description |
| - | - |
| token string  Returned | Unique identifier of the adjustment. If in the `detail_object`, unique identifier of the detail object. **Allowable Values:**  36 char max |
| account\_token string  Returned | Unique identifier of the credit account on which the adjustment was made. **Allowable Values:**  36 char max  Existing account token |
| type string  Returned | Type of adjustment. The adjustment is made on its correlating amount (for example, purchase adjustments are made on purchase amounts). You can use general adjustments for standalone adjustments made on the credit account balance itself, which includes account write-offs, credits, and more. **Allowable Values:**  `PURCHASE`, `FEE`, `REWARD`, `INTEREST`, `GENERAL` |
| original\_ledger\_entry\_token uuid  Conditionally returned | Unique identifier of the original journal entry needing the adjustment. **Allowable Values:**  Existing journal entry token |
| external\_adjustment\_id uuid  Conditionally returned | Unique identifier you provide of an associated external adjustment that exists outside Marqeta's credit platform. **Allowable Values:**  255 char max |
| detail\_token string  Conditionally returned | Unique identifier of the adjustment detail. For example, the token of the dispute, the interest charge, or the returned payment that prompted the adjustment. Returned when the system automatically applies an adjustment. **Allowable Values:**  36 char max |
| adjustment\_detail\_object object  Conditionally returned | Contains the adjustment's full details. The fields returned in this object depend on the adjustment type. Interest returns interest details. For the specific fields returned, see the `detail_object` fields marked "Returned for interest journal entries" in the [account journal entry response fields](https://www.marqeta.com/docs/core-api/credit-account-journal-entries/retrieve-account-journal-entry.md). Disputes return dispute details. For the specific fields returned, see the [dispute response fields](https://www.marqeta.com/docs/core-api/credit-account-disputes/retrieve-account-dispute.md). **Allowable Values:**  Existing `adjustment_detail_object` |
| related\_detail\_token string  Conditionally returned | Unique identifier of the dispute or returned payment that prompted the interest adjustment. This field is returned for interest adjustments only. **Allowable Values:**  36 char max |
| related\_detail\_object object  Conditionally returned | Contains full details of the related dispute or returned payment. The fields returned in this object depend on whether a dispute or returned payment led to the interest adjustment. A dispute returns dispute details; a returned payment returns payment details. For more on the dispute details returned, see the [dispute response fields](https://www.marqeta.com/docs/core-api/credit-account-disputes/retrieve-account-dispute.md). For more on the returned payment details returned, see the [payment response fields](https://www.marqeta.com/docs/core-api/credit-account-payments/retrieve-account-payment.md). This field is returned for interest adjustments only. **Allowable Values:**  Existing `related_detail_object` |
| amount decimal  Returned | Amount of the adjustment. **Allowable Values:**  Format: 0.00 |
| currency\_code string  Returned | Valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html). **Allowable Values:**  `USD` |
| description string  Returned | Description of the adjustment. **Allowable Values:**  1 char min |
| note string  Conditionally returned | Additional information on the adjustment. **Allowable Values:**  255 char max |
| reason string  Returned | Reason for the adjustment. - `DISPUTE` - The adjustment occurred because a dispute was initiated. - `DISPUTE_RESOLUTION` - The adjustment occurred because of the result of a dispute resolution. - `RETURNED_OR_CANCELED_PAYMENT` - The adjustment occurred because a payment was returned or canceled. - `OTHER` - Any other reason the adjustment occurred. For example, a waived fee. **Allowable Values:**  `DISPUTE`, `DISPUTE_RESOLUTION`, `RETURNED_OR_CANCELED_PAYMENT`, `OTHER` |
| created\_time datetime  Conditionally returned | Date and time when the account adjustment was applied, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |

## Sample response body

```json JSON lines wrap theme={null}
{
  "token": "my_account_adjustment_token1234",
  "account_token": "my_account_token_12",
  "type": "FEE",
  "original_ledger_entry_token": "a0216141-13d6-e2e2-7227-abcd12345678",
  "external_adjustment_id": null,
  "detail_token": null,
  "adjustment_detail_object": null,
  "related_detail_token": null,
  "related_detail_object": null,
  "amount": -25,
  "currency_code": "USD",
  "description": "Waived late payment fee",
  "note": null,
  "reason": "OTHER",
  "created_time": "2025-04-01T23:41:58.802Z"
}
```


## Related topics

- [Adjustments Overview](https://www.marqeta.com/docs/core-api/credit-account-adjustments.md)
- [Retrieve account adjustment](https://www.marqeta.com/docs/core-api/credit-account-adjustments/retrieve-account-adjustment.md)
- [List account adjustments](https://www.marqeta.com/docs/core-api/credit-account-adjustments/list-account-adjustments.md)
- [Credit Account Adjustments](https://www.marqeta.com/docs/diva-api/credit-account-adjustments.md)
- [Create account holder group](https://www.marqeta.com/docs/core-api/account-holder-groups/create-account-holder-group.md)
