> ## Documentation Index
> Fetch the complete documentation index at: https://align.tolbel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create External Account

> Link a bank account for receiving fiat withdrawals

## Method Signature

```typescript theme={null}
align.externalAccounts.create(
  customerId: string,
  data: CreateExternalAccountRequest
): Promise<ExternalAccount>
```

## Parameters

<ParamField path="customerId" type="string" required>
  Customer identifier
</ParamField>

<ParamField body="account_type" type="'us' | 'iban'" required>
  Account type
</ParamField>

<ParamField body="bank_name" type="string" required>
  Name of the bank
</ParamField>

<ParamField body="account_holder_type" type="'individual' | 'business'" required>
  Type of account holder
</ParamField>

<ParamField body="account_holder_address" type="object" required>
  <Expandable title="Address Properties">
    <ParamField body="country" type="string" required>
      ISO 2-letter country code
    </ParamField>

    <ParamField body="city" type="string" required>
      City
    </ParamField>

    <ParamField body="street_line_1" type="string" required>
      Street address
    </ParamField>

    <ParamField body="postal_code" type="string" required>
      Postal code
    </ParamField>
  </Expandable>
</ParamField>

### US Account Fields (required if account\_type is 'us')

<ParamField body="us" type="object">
  <Expandable title="US Account Properties">
    <ParamField body="account_number" type="string" required>
      Bank account number
    </ParamField>

    <ParamField body="routing_number" type="string" required>
      9-digit ABA routing number
    </ParamField>
  </Expandable>
</ParamField>

### IBAN Account Fields (required if account\_type is 'iban')

<ParamField body="iban" type="object">
  <Expandable title="IBAN Properties">
    <ParamField body="iban_number" type="string" required>
      International Bank Account Number
    </ParamField>

    <ParamField body="bic" type="string" required>
      Bank Identifier Code
    </ParamField>
  </Expandable>
</ParamField>

## Examples

### US Bank Account

<Tabs>
  <Tab title="TypeScript">
    ```typescript theme={null}
    import Align from "@tolbel/align";

    const align = new Align({
      apiKey: process.env.ALIGN_API_KEY!,
      environment: "sandbox",
    });

    const account = await align.externalAccounts.create(customerId, {
      account_type: "us",
      bank_name: "Chase Bank",
      account_holder_type: "individual",
      account_holder_first_name: "Alice",
      account_holder_last_name: "Smith",
      account_holder_address: {
        country: "US",
        city: "San Francisco",
        street_line_1: "123 Market St",
        postal_code: "94105"
      },
      us: {
        routing_number: "021000021",
        account_number: "123456789"
      }
    });

    console.log(`Account ID: ${account.id}`);
    ```
  </Tab>
</Tabs>

### IBAN Bank Account

```typescript theme={null}
const account = await align.externalAccounts.create(customerId, {
  account_type: "iban",
  bank_name: "Deutsche Bank",
  account_holder_type: "individual",
  account_holder_first_name: "Hans",
  account_holder_last_name: "Mueller",
  account_holder_address: {
    country: "DE",
    city: "Berlin",
    street_line_1: "Unter den Linden 1",
    postal_code: "10117",
  },
  iban: {
    iban_number: "DE89370400440532013000",
    bic: "COBADEFFXXX",
  },
});

console.log(`Account ID: ${account.id}`);
```

<Info>
  Linked bank accounts are verified automatically. Use the account ID in offramp
  transfers once verified.
</Info>

## Related Methods

<CardGroup cols={2}>
  <Card title="List Accounts" icon="list" href="/docs/api/external-accounts/list">
    List linked accounts
  </Card>

  <Card title="Create Transfer" icon="paper-plane" href="/docs/api/transfers/create-transfer">
    Use in offramp transfers
  </Card>
</CardGroup>