Skip to main content
POST
Save a bank account for a user (raw entry)

Authorizations

api_key
string
header
required

Program API key identifying your integration. Pass as the api_key HTTP header (preferred) or as an api_key field in the JSON request body. Required on every request in addition to the HMAC Authorization header.

Body

application/json
user_id
string
required

Identifier of the target user. Required when the endpoint operates on a specific user.

Example:

"user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef"

idempotent_key
string
required

Client-supplied idempotency token. Submitting the same key twice returns the first response rather than creating a duplicate transaction.

first_name
string
required

First name.

last_name
string
required

Last name.

account_number
string
required

Bank account number (5-20 digits).

routing_number
string
required

ABA routing number (9 digits).

api_key
string

Program API key. Accepted either in the api_key HTTP header or as this body field.

postal_code
string

5-digit US ZIP code.

country
string

ISO 3166-1 alpha-2 country code.

state
string

ISO 3166-2 two-letter state/region code.

city
string

City.

address_one
string

Street address line 1.

fingerprint
string

Tokenised fingerprint representing the linked account.

Response

Success.

status
enum<string>
required
Available options:
success
message
string
required
Example:

"operation completed"

data
object

Endpoint-specific payload; shape varies per operation.