---
title: "Attach Number To Agent"
method: POST
path: "/v1/agents/{agent_id}/numbers"
tags: ["agents"]
---

# Attach Number To Agent

`POST /v1/agents/{agent_id}/numbers`

Attach an existing phone number to an agent.

The number must belong to the same account and not be released.

## Path parameters

- `agent_id` string, required

## Request body

- AttachNumberRequest
  - `numberId` string, required

## Response `200`

Successful Response

- AttachNumberResponse
  - `agentId` string, required
  - `number` AgentNumberResponse, required
    - `id` string, required
    - `phoneNumber` string, required
    - `status` string, required
    - `type` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/agentphone/apis/agentphone-api.md) · [All operations](https://skmtc.net/agentphone/apis/agentphone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agentphone/agentphone-api/versions/3f3aa65dcd20/schema)