Skip to main content
Link a new bank account to your business by submitting the account holder’s legal name, a display name, full account number, routing number, and account type. Once created, Cleo Pay initiates the micro-deposit verification process automatically — two small deposits will arrive in the account within 1–3 business days.

​
HTTP Request

​
Authentication

Include your bearer token on every request:

​
Request Body

​
string
required
The legal name of the account holder exactly as it appears on the bank account. This is used for payment processing and account validation.
​
string
required
A human-readable display name for this account (e.g. "Primary Operating Account"). This is for your own reference and is returned in all subsequent responses.
​
string
required
The full bank account number. This value is write-only — it is never returned in any API response after creation.
​
string
required
The 9-digit ABA routing number for the account. This value is write-only — it is never returned in any API response after creation.
​
string
required
The type of bank account. Must be one of checking or savings.

​
Response Fields

A successful request returns HTTP 201 Created with the new bank account object.
​
string
required
Unique identifier for the bank account.
​
string
required
The initial status of a newly created account is pending_verification, indicating that micro-deposits have been initiated.
​
string
required
The bank account type you submitted: checking or savings.
​
string
required
Always manual for accounts created via the API.
​
string | null
The display name you provided.
​
string | null
The name of the financial institution, if resolved from the routing number.
​
string | null
The last four digits of the account number you submitted.
​
string | null
The last four digits of the routing number you submitted.
​
boolean
required
Whether this account has been set as the default for your business.
​
datetime | null
The timestamp at which micro-deposits were initiated. Populated immediately on successful account creation.
​
datetime | null
The timestamp at which micro-deposits landed in the account. This will be null until the deposits arrive (typically 1–3 business days).
​
number
required
The number of failed verification attempts. Always 0 on a newly created account.

​
Example Request

​
Example Response

accountNumber and routingNumber are write-only fields. After creation, only the last four digits of each are accessible via accountNumberLast4 and routingNumberLast4. Store sensitive account details securely before submitting them to the API if you need to retain them.
Micro-deposits are initiated automatically upon account creation. Check microDepositsCompletedAt on the account — once it is non-null, the deposits have landed and you can call the verify micro-deposits endpoint to complete verification.