Create a pricing unit conversion rate | Grant

Adds a settlement conversion rate for a pricing unit. Date ranges may not overlap.

AuthorizationBearer

API key obtained from the Grant dashboard

idstringRequiredformat: "cuid"

This endpoint expects an object.

money_minorstring or integerRequired

Settlement currency amount in minor units, e.g. cents

unit_amountstring or integerRequired

Number of pricing-unit units represented by money_minor

effective_fromstring or nullOptionalformat: "^\d{4}-\d{2}-\d{2}(T.*)?$"

Start of this conversion rate. Required for subsequent rates after the initial open-ended rate.

effective_tostring or nullOptionalformat: "^\d{4}-\d{2}-\d{2}(T.*)?$"

Optional exclusive end of this conversion rate

settlement_currency_codeenumOptional

Settlement currency. Defaults to usd.

customer_idstring or nullOptionalformat: "cuid"

Optional customer scope. A scoped rate overrides the company default for this customer.

Conversion rate created

successboolean

conversion_rateobject

request_idstring

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error

1	import { AfternoonClient } from "grant-sdk";
2
3	async function main() {
4	const client = new AfternoonClient({
5	token: "YOUR_TOKEN_HERE",
6	});
7	await client.pricingUnits.createConversionRate("cm5x9z8nv0008h85r7l9p2k9m", {
8	moneyMinor: "100",
9	unitAmount: "1000",
10	});
11	}
12	main();

1	{
2	"success": true,
3	"conversion_rate": {
4	"id": "cm5x9z8nv000ah85r7l9p2l1m",
5	"pricing_unit_id": "cm5x9z8nv0008h85r7l9p2k9m",
6	"customer_id": null,
7	"settlement_currency_code": "usd",
8	"effective_from": "2026-01-01T00:00:00.000Z",
9	"effective_to": null,
10	"money_minor": "100",
11	"unit_amount": "1000",
12	"created_at": "2024-01-15T10:30:00.000Z"
13	},
14	"request_id": "req_abc123"
15	}