---
title: "Assign Number to Trunk"
method: POST
path: "/api/v1/Account/{auth_id}/numbers/{phone_number}/assign"
tags: ["Phone Numbers"]
---

# Assign Number to Trunk

`POST /api/v1/Account/{auth_id}/numbers/{phone_number}/assign`

## Request

- Base URL: `https://api.vobiz.ai`
- URL: `https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers/{phone_number}/assign`
- Auth: API key in header `X-Auth-ID` and API key in header `X-Auth-Token`
- TypeScript: <https://skmtc.dev/vobiz/apis/vobiz-api/docs/api/v1/Account/:auth_id/numbers/:phone_number/assign/post.ts> (a function with typed inputs; its response is checked against the schema)

Assign a phone number to a specific SIP trunk. Once assigned, all
inbound calls to that phone number will be routed through the
designated trunk. The phone number must be URL-encoded; use `%2B`
instead of `+` (e.g., `%2B912271264217`).

## Path parameters

- `auth_id` string, required
- `phone_number` string, required

## Request body

- object
  - `trunk_group_id` string, uuid, required: The UUID of the trunk to assign this number to.

## Response `204`

Number assigned to trunk

## Other responses

- `400`: Invalid request (e.g., already assigned)
- `404`: Number not found

---

[API](https://skmtc.dev/vobiz/apis/vobiz-api.md) - [All operations](https://skmtc.dev/vobiz/apis/vobiz-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vobiz/apis/vobiz-api/revisions/863f08cd6737?raw)