> ## 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 interest tier rate

> Creates an interest rate for a tier.

PUT/v3/interestaccounts/interesttiers/\{interest\_tier\_token}/rates

Creates an interest rate for a tier.
The effective date must be a future date.
The rate cannot exceed the program's interest rate for the account type on the effective date.

## URL path parameters

| Fields | Description |
| - | - |
| interest\_tier\_token string  Required | Unique identifier of the interest tier, as returned by the `POST /v3/interestaccounts/interesttiers` endpoint. **Allowable Values:**  Existing interest tier token |

## Request body

| Fields | Description |
| - | - |
| effective\_date string  Required | Date on which the rate takes effect. Must be a future date. **Allowable Values:**  Format: yyyy-MM-dd |
| note string  Optional | Optional note describing the reason for the rate change. **Allowable Values:**  Example: Q3 2026 rate adjustment.  255 char max |
| account\_rate decimal  Required | The gross interest rate, also known as the nominal interest rate. This is the base rate, calculated without compounding. Cannot exceed the program's interest rate for the account type on the effective date. **Allowable Values:**  0–100 |

## Sample request body

Create rate for a checking tier

```json JSON expandable lines wrap theme={null}
{
  "effective_date": "2026-07-01",
  "account_rate": 3.75,
  "note": "Q3 2026 rate adjustment."
}
```

Create rate for a savings tier

```json JSON expandable lines wrap theme={null}
{
  "effective_date": "2026-07-01",
  "account_rate": 4.5,
  "note": "Q3 2026 rate adjustment."
}
```

## Response body

| Fields | Description |
| - | - |
| note string  Conditionally returned | Optional note describing the reason for the rate change. **Allowable Values:**  Example: Q3 2026 rate adjustment.  255 char max |
| account\_rate decimal  Returned | The gross interest rate, also known as the nominal interest rate. This is the base rate, calculated without compounding. **Allowable Values:**  0–100 |
| effective\_rate decimal  Conditionally returned | The effective interest rate, also known as the annual percentage yield (APY) or annual equivalent rate (AER) — the daily compounding rate applied to the account's balance. **Allowable Values:**  0–100 |
| effective\_date string  Returned | Date the rate takes effect. **Allowable Values:**  Format: yyyy-MM-dd |
| created\_time datetime  Returned | Date and time when the rate was created, in UTC. **Allowable Values:**  Example: 2026-01-15T09:00:00Z  Format: yyyy-MM-ddThh:mm:ssZ |
| updated\_time datetime  Returned | Date and time when the rate was last updated, in UTC. **Allowable Values:**  Example: 2026-06-01T12:00:00Z  Format: yyyy-MM-ddThh:mm:ssZ |

## Sample response body

Rate created for checking tier

```json JSON expandable lines wrap theme={null}
{
  "account_rate": 3.75,
  "effective_rate": 3.82,
  "effective_date": "2026-07-01",
  "note": "Q3 2026 rate adjustment.",
  "created_time": "2026-06-01T12:00:00Z",
  "updated_time": "2026-06-01T12:00:00Z"
}
```

Rate created for savings tier

```json JSON expandable lines wrap theme={null}
{
  "account_rate": 4.5,
  "effective_rate": 4.6,
  "effective_date": "2026-07-01",
  "note": "Q3 2026 rate adjustment.",
  "created_time": "2026-06-01T12:00:00Z",
  "updated_time": "2026-06-01T12:00:00Z"
}
```

## Error codes

| Error Code | Error Message |
| - | - |
| `400001` | Invalid input(s) detected |
| `400917` | Effective date must be later than today. |
| `500000` | Internal server error |

If the `account_rate` exceeds the program's rate, this endpoint returns error code `400001` with the message `The account rate cannot exceed the program's rate.`

See [Errors](https://www.marqeta.com/docs/core-api/errors.md) for the complete list of error codes.


## Related topics

- [Interest Tier Rates Overview](https://www.marqeta.com/docs/core-api/interest-accounts/interest-tier-rates.md)
- [Interest Accounts Overview](https://www.marqeta.com/docs/core-api/interest-accounts.md)
- [Create interest tier](https://www.marqeta.com/docs/core-api/interest-accounts/interest-tiers/create-tier.md)
- [List interest tier rates](https://www.marqeta.com/docs/core-api/interest-accounts/interest-tier-rates/list-tier-rates.md)
- [Retrieve interest tier rate](https://www.marqeta.com/docs/core-api/interest-accounts/interest-tier-rates/retrieve-tier-rate.md)