Create an Account

Creates an account by passing the required account information.
Create an Account
 last updated: 
December 15, 2021

You need to pass the businessId in the request object only if you create a business checking account. If you create a personal checking account, the personId is already included in the header.

During the account creation, it is your responsibility to present an option for the user to accept the Terms, after which you should set acceptedTerms as true in the request body. Learn more about Account Types.

ENDPOINT

  1. POST /v1/account

REQUEST

  1. {
  2.     "businessId": "{{businessId}}",
  3.     "label": "Primary",
  4.     "acceptedTerms": true,
  5.     "type": "businessChecking"
  6. }

RESPONSE

  1. {
  2.     "id": "acc-63d656eb-fedc-4250-8111-48a5ff0faed9",
  3.     "businessId": "bus-0fc3d3cb-f2bf-407b-8377-77acc57f5ea6",
  4.     "label": "Primary",
  5.     "routingNumber": "084106768",
  6.     "accountNumber": "9990001157174403",
  7.     "status": "active",
  8.     "type": "businessChecking",
  9.     "programId": "prg-b9f17601-4717-460e-bda5-9598f6f6db28",
  10.     "isVerified": false,
  11.     "verifiedAt": "",
  12.     "acceptedTerms": true,
  13.     "interest": "0.50",
  14.     "fees": "0.00",
  15.     "currency": "USD",
  16.     "availableBalance": "1000.00",
  17.     "sponsorBankName": "Evolve",
  18.     "createdAt": "2021-12-15T21:20:33Z",
  19.     "modifiedAt": "2021-12-15T21:20:33Z",
  20.     "pendingDebit": "0.00",
  21.     "pendingCredit": "0.00",
  22.     "createdPersonId": "per-3ebfa3d2-5d36-411d-984a-9e3a328011c5",
  23.     "accountInterestFrequency": "annual",
  24.     "metadata": null,
  25.     "config": {
  26.         "card": {
  27.             "virtual": {
  28.                 "enabled": true,
  29.                 "count": "1000"
  30.             },
  31.             "physical": {
  32.                 "enabled": true,
  33.                 "count": "100"
  34.             }
  35.         },
  36.         "send": {
  37.             "intrabank": {
  38.                 "enabled": true
  39.             },
  40.             "ach": {
  41.                 "enabled": true,
  42.                 "sameDay": false
  43.             },
  44.             "wire": {
  45.                 "enabled": true
  46.             },
  47.             "check": {
  48.                 "enabled": true
  49.             },
  50.             "card": {
  51.                 "enabled": true
  52.             },
  53.             "debitCard": {
  54.                 "enabled": false
  55.             }
  56.         },
  57.         "receive": {
  58.             "intrabank": {
  59.                 "enabled": true
  60.             },
  61.             "ach": {
  62.                 "enabled": true,
  63.                 "sameDay": false
  64.             },
  65.             "check": {
  66.                 "enabled": true
  67.             },
  68.             "debitCard": {
  69.                 "enabled": false
  70.             }
  71.         },
  72.         "limits": {
  73.             "send": {
  74.                 "daily": "2000.00",
  75.                 "monthly": "300000.53"
  76.             },
  77.             "receive": {
  78.                 "daily": "4000000.00",
  79.                 "monthly": "12000000.00"
  80.             }
  81.         },
  82.         "fallback": {
  83.             "originated": null,
  84.             "received": null
  85.         }
  86.     }
  87. }