# External Accounts

## List

**get** `/external-accounts`

Lists all external accounts for the workspace

### Returns

- `data: array of object { id, external_id, name }`

  - `id: string`

    Fragment-generated unique ID for the external account

  - `external_id: string`

    User-provided external ID

  - `name: string`

    Human-readable name for the external account

### Example

```http
curl https://api.us-west-2.fragment.dev/external-accounts
```

## Create

**post** `/external-accounts`

Creates a new external account

### Body Parameters

- `external_id: string`

  External ID for the account (user-provided, unique, mutable)

- `name: string`

  Human-readable name for the external account (mutable)

### Returns

- `data: object { id, external_id, name }`

  External account object

  - `id: string`

    Fragment-generated unique ID for the external account

  - `external_id: string`

    User-provided external ID

  - `name: string`

    Human-readable name for the external account

### Example

```http
curl https://api.us-west-2.fragment.dev/external-accounts \
    -H 'Content-Type: application/json' \
    -d '{
          "external_id": "ext_acc_123",
          "name": "Checking Account"
        }'
```