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

# Create FBO Account Alias

> Add an alternate vault ID to an FBO account

Adds an alternate vault ID (alias) to an FBO account. Intake can then resolve this ID to the same account as the canonical `vaultId`.

The account must already have a canonical vault ID. An alias must be 7–20 digits and cannot be in use by another FBO account.

**Permission:** `fbo_accounts:update`

## Path parameters

<ParamField path="id" type="string" required>
  The FBO account ID
</ParamField>

## Request body

<ParamField body="aliasVaultId" type="string" required>
  Alternate vault ID. Digits only (spaces and hyphens are stripped). Must be 7–20 digits.
</ParamField>

<ParamField body="source" type="string">
  Optional label for where the alias came from (for example `legacy` or `import`). Defaults to
  `api`.
</ParamField>

## Response

Returns the created alias.

```json theme={null}
{
  "data": {
    "id": "ja7aliasnew",
    "fboAccountId": "m97fbo456",
    "aliasVaultId": "1234567",
    "source": "api",
    "isActive": true,
    "updatedAt": "2025-06-15T09:00:00.000Z",
    "createdAt": "2025-06-15T09:00:00.000Z"
  }
}
```

<Note>
  This endpoint supports the `Idempotency-Key` header. Replaying a request with the same key returns
  the original response instead of creating a second alias.
</Note>