---
title: "Create interest tier schedule"
method: POST
path: "/v1/financial_accounts/{financial_account_token}/interest_tier_schedule"
tags: ["Statements"]
---

# Create interest tier schedule

`POST /v1/financial_accounts/{financial_account_token}/interest_tier_schedule`

## Request

- Base URL: `https://sandbox.lithic.com`
- URL: `https://sandbox.lithic.com/v1/financial_accounts/{financial_account_token}/interest_tier_schedule`
- Auth: API key in header `Authorization`

Create a new interest tier schedule entry for a supported financial account

## Path parameters

- `financial_account_token` string, uuid, required

## Request body

- TierScheduleEntry: Entry in the Tier Schedule of an account
  - `tier_name` string, nullable: Name of a tier contained in the credit product. Mutually exclusive with tier_rates
  - `effective_date` string, date, required: Date the tier should be effective in YYYY-MM-DD format
  - `tier_rates` object, nullable: Custom rates per category. Mutually exclusive with tier_name
  - `penalty_rates` object, nullable: Custom rates per category for penalties
  - `credit_product_token` string, required: Globally unique identifier for a credit product

## Response `201`

Created

- TierScheduleEntry: Entry in the Tier Schedule of an account
  - `tier_name` string, nullable: Name of a tier contained in the credit product. Mutually exclusive with tier_rates
  - `effective_date` string, date, required: Date the tier should be effective in YYYY-MM-DD format
  - `tier_rates` object, nullable: Custom rates per category. Mutually exclusive with tier_name
  - `penalty_rates` object, nullable: Custom rates per category for penalties
  - `credit_product_token` string, required: Globally unique identifier for a credit product

## Other responses

- `400`: A parameter in the query given in the request does not match the valid queries for the endpoint.
- `401`: | | | |---|---| | User has not been authenticated | Invalid or missing API key | | API key is not active | The API key used is no longer active | | Could not find API key | The API key provided is not associated with any user | | Please provide API key in Authorization header | The Authorization header is not in the request | | Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly | | Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at [lithic.com/contact](https://lithic.com/contact) | | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege | Reach out at [lithic.com/contact](https://lithic.com/contact) |
- `404`: The specified resource was not found.
- `422`: Unprocessable entity.
- `429`: Client has exceeded the number of allowed requests in a given time period. | | | |---|---| | Rate limited, too many requests per second | User has exceeded their per second rate limit | | Rate limited, reached daily limit | User has exceeded their daily rate limit | | Rate limited, too many keys tried | One IP has queried too many different API keys |

## Changes

- **2026-10-20** `1d396cf44717`: 3 breaking, 3 info
  - the response property `penalty_rates` became nullable for the status `201`
  - the response property `tier_name` became nullable for the status `201`
  - the response property `tier_rates` became nullable for the status `201`
  - the request property `penalty_rates` became nullable
  - …2 more

[Operation history](https://skmtc.dev/lithic-com/apis/lithic-developer-api/changes/v1/financial_accounts/:financial_account_token/interest_tier_schedule/post.md)

---

[API](https://skmtc.dev/lithic-com/apis/lithic-developer-api.md) - [All operations](https://skmtc.dev/lithic-com/apis/lithic-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lithic-com/apis/lithic-developer-api/revisions/4614c122881f?raw)