---
title: "Create Account by Account and Routing"
method: POST
path: "/v1/accounts/create"
tags: ["Accounts"]
---

# Create Account by Account and Routing

`POST /v1/accounts/create`

> 📘
>
> You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.

This endpoint will create an Account for a User based on an account and routing number.

> ❗️ This resource requires the use of the secure endpoint.
>
> | Environment | Secure Endpoint                                             |
> |-------------|-------------------------------------------------------------|
> | Production  | https://secure.api.astra.finance/v1/accounts/create         |
> | Sandbox     | https://secure.api-sandbox.astra.finance/v1/accounts/create |

> 🚧
>
> Your Institution ID in Sandbox may be different than your Institution ID in Production. Please check the Client Details section of your Astra Dashboard to confirm.

> 🚧
>
> If you are creating an account in Sandbox, the Routing number must be a real-world Routing number. Account numbers in Sandbox should not be real-world. If you do not have a Routing number readily available, you can use `222222226`.

> 🚧
>
> Account numbers must be at minimum 7 digits and no greater than 17. For account numbers less than 7 digits, you must prepend zeros to the beginning of the account number. For example: an account number of `12345` should be registered as `0012345`.

> 📘
>
> Although required, the `Name` field is internal facing, and isn’t available for your Users to see unless you explicitly make this field visible to them through your application. The `Name` field also doesn’t appear on Bank Statements. This field was primarily designed for internal tracking of accounts.

## Request body

- object
  - `institution_id` string, required — The Institution ID given to you by Astra, which can be found in the Client Details section of your Astra Dashboard
  - `name` string, required — The name for the Account
  - `bank_account_type` string, required — The type of bank account (checking or savings)
  - `account_number` string, required — The bank account number
  - `routing_number` string, required — The bank routing number

## Response `201`

Successful response

- object
  - `id` string — Unique ID of the account
  - `official_name` string — Official name of the account
  - `name` string — Name of the account
  - `mask` string — Masked account number
  - `institution_name` string — Institution name of the account
  - `institution_logo` string — Logo of the institution
  - `type` string — Type of the account
  - `subtype` string — Subtype of the account
  - `connection_status` string — Connection status of the account

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/astra/apis/astra-developer-api.md) · [All operations](https://skmtc.net/astra/apis/astra-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astra/astra-developer-api/revisions/09f0430e5d33/schema)