---
title: "Create an ACH Relationship"
method: POST
path: "/v1/accounts/{account_id}/ach_relationships"
tags: ["Funding"]
---

# Create an ACH Relationship

`POST /v1/accounts/{account_id}/ach_relationships`

## Request

- Base URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets`
- URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets/v1/accounts/{account_id}/ach_relationships`
- Auth: HTTP basic

Create a new ACHRelationship for an account

If successful, will return 200 code with a newly created ACH Relationship entity.

## Request body

- CreateACHRelationshipRequest: Represents the fields used in creation of a new ACHRelationship. You can create an ACHRelationship by passing the required fields here or if you have an account with Plaid you can use our integration with Plaid to create a relationship. Please see the documentation [here](https://alpaca.markets/docs/api-references/broker-api/funding/ach/#plaid-integration-for-bank-transfers) for more info on using Plaid with Alpaca
  - `account_owner_name` string, required
  - `bank_account_number` string, required: In sandbox, this still must be a valid format
  - `bank_account_type` 'CHECKING' | 'SAVINGS', required: Must be `CHECKING` or `SAVINGS`
  - `bank_routing_number` string, required: In sandbox, this still must be a valid format
  - `instant` boolean
  - `nickname` string
  - `processor_token` string: If using Plaid, you can specify a Plaid processor token here

## Response `200`

returns the newly created ACH Relationship entity.

- ACHRelationship
  - `account_id` string, uuid, required
  - `account_owner_name` string, required: Name of the account owner
  - `bank_account_number` string
  - `bank_account_type` 'CHECKING' | 'SAVINGS': Must be CHECKING or SAVINGS
  - `bank_routing_number` string
  - `created_at` string, date-time, required: Format: 2020-01-01T01:01:01Z
  - `id` string, uuid, required
  - `nickname` string
  - `status` 'QUEUED' | 'APPROVED' | 'REJECTED' | 'PENDING' | 'CANCEL_REQUESTED', required
  - `updated_at` string, date-time, required: Format: 2020-01-01T01:01:01Z

## Other responses

- `400`: Malformed input.
- `401`: Client is not authorized for this operation.
- `409`: The account already has an active relationship.

---

[API](https://skmtc.dev/alpacahq/apis/broker-api.md) - [All operations](https://skmtc.dev/alpacahq/apis/broker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alpacahq/apis/broker-api/revisions/381b1ecb3ccc?raw)