---
title: "Create a scheduled fiat withdrawal"
method: POST
path: "/v3/withdrawals/fiat/schedules"
tags: ["Fiat withdrawal"]
---

# Create a scheduled fiat withdrawal

`POST /v3/withdrawals/fiat/schedules`

## Request

- Base URL: `https://confirmo.net/api`
- URL: `https://confirmo.net/api/v3/withdrawals/fiat/schedules`
- Auth: HTTP bearer

Configures a recurring sweep of the merchant's fiat balance to a registered bank account. On success returns the newly created schedule in status ACTIVE. Accepts API keys only.

## Request body

- CreateFiatWithdrawalScheduleRestRequest
  - `accountId` string, required: ID of the fiat withdrawal account to sweep.
  - `currency` 'AED' | 'ALL' | 'AMD' | 'ARS' | 'AUD' | 'AZN' | 'BDT' | 'BGN' | 'BHD' | 'BND' | 'BOB' | 'BRL' | 'BYN' | 'CAD' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CVE' | 'CZK' | 'DKK' | 'DOP' | 'DZD' | 'EUR' | 'FKP' | 'GBP' | 'GEL' | 'GTQ' | 'HKD' | 'HRK' | 'HUF' | 'CHF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JMD' | 'JPY' | 'KGS' | 'KHR' | 'KWD' | 'KZT' | 'LTL' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MNT' | 'MOP' | 'MUR' | 'MXN' | 'MYR' | 'NGN' | 'NIO' | 'NOK' | 'NZD' | 'PEN' | 'PHP' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'UAH' | 'USD' | 'UYU' | 'VND' | 'XCD', required: Currency to sweep.
  - `frequency` 'DAILY' | 'WEEKLY' | 'MONTHLY', required: Sweep cadence.
  - `frequencyDay` integer: Day selector for the sweep. Null for DAILY; 1-7 (Monday=1) for WEEKLY; 1-31 for MONTHLY.
  - `minimumAmount` number: Optional minimum the net swept amount must reach for a withdrawal to be created. When the sweep is below this value the run is skipped. Omit for no minimum.
  - `minimumBalance` number, required: Balance floor in major units of the selected currency. Only the excess above this floor is swept.

## Response `201`

Schedule created successfully.

- FiatWithdrawalScheduleRestResponse
  - `accountId` string: ID of the fiat withdrawal account being swept.
  - `createdAt` integer: When the schedule was created.
  - `currency` 'AED' | 'ALL' | 'AMD' | 'ARS' | 'AUD' | 'AZN' | 'BDT' | 'BGN' | 'BHD' | 'BND' | 'BOB' | 'BRL' | 'BYN' | 'CAD' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CVE' | 'CZK' | 'DKK' | 'DOP' | 'DZD' | 'EUR' | 'FKP' | 'GBP' | 'GEL' | 'GTQ' | 'HKD' | 'HRK' | 'HUF' | 'CHF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JMD' | 'JPY' | 'KGS' | 'KHR' | 'KWD' | 'KZT' | 'LTL' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MNT' | 'MOP' | 'MUR' | 'MXN' | 'MYR' | 'NGN' | 'NIO' | 'NOK' | 'NZD' | 'PEN' | 'PHP' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'UAH' | 'USD' | 'UYU' | 'VND' | 'XCD': Currency being swept.
  - `frequency` 'DAILY' | 'WEEKLY' | 'MONTHLY': Sweep cadence.
  - `frequencyDay` integer: Day selector. Null for DAILY; 1-7 (Monday=1) for WEEKLY; 1-31 for MONTHLY.
  - `id` string: ID of the schedule.
  - `minimumAmount` number: Minimum the net swept amount must reach for a withdrawal to be created. Null when no minimum is enforced.
  - `minimumBalance` number: Balance floor — only the excess above this value is swept.
  - `nextRunAt` integer: When the schedule will next be processed by the sweep job.
  - `status` 'ACTIVE' | 'PAUSED' | 'CANCELLED' | 'DELETED': Current status of the schedule.

## Other responses

- `400`: Validation failed.
- `403`: Not an API key, or the API key does not have write permission
- `409`: Conflict

---

[API](https://skmtc.dev/confirmo/apis/confirmo-api.md) - [All operations](https://skmtc.dev/confirmo/apis/confirmo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/confirmo/apis/confirmo-api/revisions/09bef7db3dd1?raw)