Create a new subaccount
Creates a new subaccount for fund segregation within your root entity’s main account.
Request Body
Response Body
Virtual Banking Details
Upon creation, each subaccount is assigned virtual banking details that can be shared with payers for direct deposits:
- Account Number: Unique account number for receiving deposits
- Routing Numbers: Use
routing_numbers.achfor ACH transfers. For JPM VRNs, userouting_numbers.wirefor wire transfers (same account number, different routing number per rail).
Use these details to configure payment processors to route funds to specific subaccounts.
Error Responses
Authentication
x-api-keystring
RootPay API key sent in the x-api-key header. Keys are environment-scoped: live_* for production, test_* for sandbox.
Request
This endpoint expects an object.
name
Name of the subaccount
Response
Subaccount created successfully