For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact SupportGet Started
  • Modernfi Developer Hub
    • Overview for Developers
    • Getting Started
  • Topics
    • Using the Sandbox
    • Authentication
    • Account Structure
    • Idempotency
    • Transaction Records and Sweeps
    • Balance Fields
    • Interest
    • Reports
    • Versioning
    • Changelog
  • API Reference
      • GETList Pricing Groups
      • POSTCreate Pricing Group
      • GETGet Pricing Group
      • DELDelete Pricing Group
      • PATCHUpdate Pricing Group Metadata
      • PUTUpdate Pricing Group Rates
      • POSTAssign Accounts To Pricing Group
      • DELUnassign Accounts From Pricing Group
LogoLogo
Contact SupportGet Started
API ReferencePricing Groups

Create Pricing Group

POST
/digital-banking/v1/pricing-groups
POST
/digital-banking/v1/pricing-groups
$curl -X POST https://api.modernfi.com/digital-banking/v1/pricing-groups \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "name": "string",
>  "interest_rate_tiers": [
>    {
>      "min_balance": 1.1,
>      "max_balance": 1.1
>    }
>  ]
>}'
1{
2  "id": "string",
3  "institution_id": "string",
4  "name": "string",
5  "description": "string",
6  "account_count": 1,
7  "interest_rate_tiers": [
8    {
9      "min_balance": "string",
10      "max_balance": "string",
11      "rate": "string",
12      "floating_spread": "string"
13    }
14  ],
15  "created_at": "string",
16  "updated_at": "string",
17  "accounts": [
18    {
19      "id": "string",
20      "title": "string"
21    }
22  ]
23}
Create a new pricing group with rate tiers. Pricing groups allow institutions to manage interest rates at scale by defining reusable rate structures that can be assigned to multiple accounts. When a pricing group's rates are updated, all assigned accounts receive the new rates automatically.
Was this page helpful?
Previous

Get Pricing Group

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringRequired<=128 characters

Name of the pricing group (e.g., ‘Retail Checking’, ‘Accounts 2025’)

interest_rate_tierslist of objectsRequired
Rate tiers for the pricing group. At least one tier is required.
descriptionstring or nullOptional<=256 characters
Optional description providing additional context about this pricing group
effective_atstringOptionalformat: "date-time"
When these rates become effective. Defaults to now if not provided.
account_idslist of strings or nullOptional
Optional list of account IDs to assign to this pricing group upon creation. If provided, the pricing group rates will be applied to these accounts immediately.

Response

Successful Response
idstring
institution_idstring
namestring
descriptionstring or null
account_countinteger
Number of accounts currently assigned to this pricing group
interest_rate_tierslist of objects
created_atstring
updated_atstring
accountslist of objects
List of accounts assigned to this pricing group

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error
500
Internal Server Error