Org Member Quota Increase
POST /org-member-quota/increase
Top up the payment limit (quota) for an org member. The amount is added to the member's postedQuota and availableQuota.
The org member receives a push notification when the top-up is applied.
Request
{
"orgMemberId": "om-xxxxxx",
"amount": 500,
"idempotencyKey": "topup-2026-05-22-001",
"comment": "Daily topup",
"customFieldValues": {
"cf-id-1": "Fooding",
"cf-id-2": 23.5
}
}Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
orgMemberId | string | Yes | The id of the org member to top up. |
amount | number | Yes | Amount to add to the limit. Must be > 0 and can have at most 2 decimal places. |
idempotencyKey | string | Yes | Unique key per top-up in your system. Retrying with the same key will not double-apply the top-up. |
comment | string | No | Note |
customFieldValues | object | No | Custom field values for this top-up. See Custom Field Values below. |
Custom Field Values
Only pass this if you use custom fields that are configured in marketpe. For the list of custom fields configured for your org, contact us.
Response
{
"status": "success",
"data": {
"id": "xxxxxx",
"orgMemberId": "om-xxxxxx",
"type": "increase",
"amount": 500,
"postedQuota": 5500,
"availableQuota": 4000,
"createdTime": "2026-05-22T09:30:00.000Z"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Server-generated id for this top-up. |
orgMemberId | string | The org member that was topped up. |
type | string | Always "increase". |
amount | number | The amount from the request. |
postedQuota | number | The member's new postedQuota after this top-up. |
availableQuota | number | The member's new availableQuota after this top-up. |
createdTime | string | When the top-up was applied, ISO 8601 UTC. |
Errors
Retrying with an idempotencyKey that was already used:
{
"status": "error",
"errorCode": "failed",
"message": "A quota request with this idempotencyKey has already been applied.",
"data": {
"id": "xxxxxx",
"orgMemberId": "om-xxxxxx",
"type": "increase",
"amount": 500,
"postedQuota": 5500,
"createdTime": "2026-05-22T09:30:00.000Z"
}
}data is the quota change that was already applied with this key.
Last updated on