---
title: "Attach Existing Number"
method: POST
path: "/v1/numbers/attach"
tags: ["Numbers"]
---

# Attach Existing Number

`POST /v1/numbers/attach`

## Request

- Base URL: `https://api.agentline.cloud`
- URL: `https://api.agentline.cloud/v1/numbers/attach`
- Auth: HTTP bearer

Manually attach a number that was bought outside this account.
Each agent can only have ONE active number.

Query params:
  - phone_number: E.164 format (e.g. "+12125551234")
  - agent_id: agent to attach to
  - country: "US" (default) or "CA" — both are +1, so say which

## Query parameters

- `phone_number` string, required
- `agent_id` string, required
- `country` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents.md) · [All operations](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/revisions/18c0bdbb4b30?raw)