---
updatedAt: 2026-06-05T22:10:56.000Z
agentTools:
  projectIndex: https://docs.astra.finance/llms.txt
---

# Create Account by Account and Routing

> 📘
>
> 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.


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Astra Developer API",
    "description": "Astra's public API endpoints available to our customers.",
    "version": "1.0.0"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    },
    "headers": {
      "request-id": {
        "description": "Unique ID returned with each API response",
        "schema": {
          "type": "string"
        }
      }
    },
    "schemas": {
      "generic_error": {
        "type": "object",
        "properties": {
          "code": {
            "description": "Response code",
            "type": "integer"
          },
          "name": {
            "description": "Name of response code",
            "type": "string"
          },
          "description": {
            "description": "Error message",
            "type": "string"
          }
        }
      },
      "validation_error": {
        "type": "object",
        "properties": {
          "status_code": {
            "description": "HTTP Response code",
            "type": "integer"
          },
          "description": {
            "description": "Object of invalid fields with accompanying descriptions",
            "type": "object"
          }
        }
      }
    },
    "examples": {
      "generic_error_unauthorized": {
        "summary": "Invalid or Expired Access Token",
        "value": {
          "code": 401,
          "name": "Unauthorized",
          "description": null
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api-sandbox.astra.finance",
      "description": "Sandbox Environment"
    },
    {
      "url": "https://secure.api-sandbox.astra.finance",
      "description": "Secure Sandbox URL"
    }
  ],
  "tags": [
    {
      "name": "Accounts"
    }
  ],
  "paths": {
    "/v1/accounts/create": {
      "post": {
        "tags": [
          "Accounts"
        ],
        "summary": "Create Account by Account and Routing",
        "servers": [
          {
            "url": "https://secure.api-sandbox.astra.finance",
            "description": "Secure Sandbox URL"
          }
        ],
        "description": "> 📘\n>\n> You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.\n\nThis endpoint will create an Account for a User based on an account and routing number.\n\n> ❗️ This resource requires the use of the secure endpoint.\n>\n> | Environment | Secure Endpoint                                             |\n> |-------------|-------------------------------------------------------------|\n> | Production  | https://secure.api.astra.finance/v1/accounts/create         |\n> | Sandbox     | https://secure.api-sandbox.astra.finance/v1/accounts/create |\n\n> 🚧\n>\n> 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.\n\n> 🚧\n>\n> 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`.\n\n> 🚧\n>\n> 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`.\n\n> 📘\n>\n> 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.\n",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "institution_id": {
                    "type": "string",
                    "description": "The Institution ID given to you by Astra, which can be found in the Client Details section of your Astra Dashboard"
                  },
                  "name": {
                    "type": "string",
                    "description": "The name for the Account"
                  },
                  "bank_account_type": {
                    "type": "string",
                    "description": "The type of bank account (checking or savings)"
                  },
                  "account_number": {
                    "type": "string",
                    "description": "The bank account number"
                  },
                  "routing_number": {
                    "type": "string",
                    "description": "The bank routing number"
                  }
                },
                "required": [
                  "institution_id",
                  "name",
                  "bank_account_type",
                  "account_number",
                  "routing_number"
                ]
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "201": {
            "description": "Successful response",
            "headers": {
              "request-id": {
                "$ref": "#/components/headers/request-id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Unique ID of the account"
                    },
                    "official_name": {
                      "type": "string",
                      "description": "Official name of the account"
                    },
                    "name": {
                      "type": "string",
                      "description": "Name of the account"
                    },
                    "mask": {
                      "type": "string",
                      "description": "Masked account number"
                    },
                    "institution_name": {
                      "type": "string",
                      "description": "Institution name of the account"
                    },
                    "institution_logo": {
                      "type": "string",
                      "description": "Logo of the institution"
                    },
                    "type": {
                      "type": "string",
                      "description": "Type of the account"
                    },
                    "subtype": {
                      "type": "string",
                      "description": "Subtype of the account"
                    },
                    "connection_status": {
                      "type": "string",
                      "description": "Connection status of the account"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "headers": {
              "request-id": {
                "$ref": "#/components/headers/request-id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/generic_error"
                    },
                    {
                      "$ref": "#/components/schemas/validation_error"
                    }
                  ]
                },
                "examples": {
                  "existing_routing_account": {
                    "summary": "Existing Account",
                    "value": {
                      "code": 400,
                      "name": "Bad Request",
                      "description": "A bank account with this routing number and account number has already been created."
                    }
                  },
                  "bank_account_type": {
                    "summary": "Invalid Bank Account Type",
                    "value": {
                      "code": 400,
                      "name": "Bad Request",
                      "description": "Bank account type must be either 'checking' or 'savings'."
                    }
                  },
                  "institution": {
                    "summary": "Invalid Institution ID",
                    "value": {
                      "code": 400,
                      "name": "Bad Request",
                      "description": "Please contact support for Institution INSTITUTION_ID."
                    }
                  },
                  "create_account_failed": {
                    "summary": "Account Creation Failed",
                    "value": {
                      "code": 400,
                      "name": "Bad Request",
                      "description": "Account creation failed. Please contact support."
                    }
                  },
                  "account_number": {
                    "summary": "Invalid Account Number",
                    "value": {
                      "status_code": 400,
                      "description": [
                        {
                          "account_number": "Account number may not be greater than 17 characters in length"
                        }
                      ]
                    }
                  },
                  "routing_number": {
                    "summary": "Invalid Routing Number",
                    "value": {
                      "status_code": 400,
                      "description": [
                        {
                          "routing_number": "Routing number must be nine characters in length"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "headers": {
              "request-id": {
                "$ref": "#/components/headers/request-id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/generic_error"
                    }
                  ]
                },
                "examples": {
                  "institution_not_allowed": {
                    "summary": "Unauthorized Institution ID",
                    "value": {
                      "code": 401,
                      "name": "Unauthorized",
                      "description": "Not permitted to create accounts for Institution INSTITUTION_ID."
                    }
                  },
                  "generic_error_unauthorized": {
                    "$ref": "#/components/examples/generic_error_unauthorized"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true,
    "samples-enabled": true
  }
}
```