---
title: "Assign Phone To Agent"
method: POST
path: "/api/v1/admin/livekit/phone-assignments"
tags: ["livekit-phone-admin"]
---

# Assign Phone To Agent

`POST /api/v1/admin/livekit/phone-assignments`

Assign a phone number to a LiveKit voice agent.

Creates a dispatch rule in LiveKit that routes inbound calls
to the specified agent.

The phone number must already exist in the database (imported via
the phone number import flow).

## Request body

- PhoneAssignmentCreate — Request to assign a phone number to an agent.
  - `phone_number` string, required — Phone number in E.164 format (e.g., +15105550100)
  - `voice_agent_id` string, uuid, required — Voice agent UUID to handle inbound calls

## Response `200`

Successful Response

- PhoneAssignmentRead — Response for phone assignment.
  - `phone_number` string, required
  - `tenant_id` string, uuid, nullable, required
  - `voice_agent_id` string, uuid, nullable, required
  - `dispatch_rule_id` string, nullable, required
  - `voice_platform` string, nullable, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-03** `d65b8fefae34` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/admin/livekit/phone-assignments/post.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/d782acd3a884?raw)