Create External Account

Create new External Account

post

https://api.alignlabs.devhttps://api-sandbox.alignlabs.dev

/v0/customers/{customer_id}/external-accounts

Creates external account and returns account information

Path parameters

customer_idstringRequired

The unique identifier of the customer

Header parameters

Api-KeystringRequired

Your secret API key, available in the developer dashboard. Include this header on every request to authenticate your application.

Idempotency-KeystringRequired

Unique key to prevent duplicate requests

Body

application/json

External account details for bank transfers. Can be either IBAN-based or US-based account.

or

or

Responses

201

Successful external account creation response

application/json

or

or

post

/v0/customers/{customer_id}/external-accounts

HTTPcURLJavaScriptPython

POST /v0/customers/{customer_id}/external-accounts HTTP/1.1
Host: api.alignlabs.dev
Api-Key: text
Idempotency-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 389

{
  "bank_name": "text",
  "account_holder_type": "individual",
  "account_holder_first_name": "text",
  "account_holder_last_name": "text",
  "account_holder_business_name": "text",
  "account_holder_address": {
    "country": "US",
    "city": "San Francisco",
    "street_line_1": "580 Howard, Suite PH San Francisco",
    "postal_code": "94105"
  },
  "account_type": "iban",
  "iban": {
    "bic": "DEUTDEFF",
    "iban_number": "DE89370400440532013000"
  }
}

201

Successful external account creation response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2023-01-01T00:00:00Z",
  "bank_name": "text",
  "account_holder_type": "individual",
  "account_holder_first_name": "text",
  "account_holder_last_name": "text",
  "account_holder_business_name": "text",
  "account_holder_address": {
    "country": "US",
    "city": "San Francisco",
    "street_line_1": "580 Howard, Suite PH San Francisco",
    "postal_code": "94105"
  },
  "account_type": "iban",
  "iban": {
    "iban_number": "text",
    "bic": "text"
  }
}