---
title: "Allocate a phone"
method: POST
path: "/phones/allocate"
tags: ["Phones"]
---

# Allocate a phone

`POST /phones/allocate`

Allocates a phone to a workflow from the editor. If allocation setup fails it is rolled back so the user can't be billed for a session that never starts.

## Request body

- PhoneAllocatePhoneRequest
  - `phone_id` string
  - `phone_type` string, required
  - `workflow_id` string

## Response `200`

OK

- PhoneAllocatePhoneResponse
  - `control_url` string
  - `phone_id` string, required
  - `region` string
  - `session_id` string, required
  - `workflow_started_at` string, date-time, required

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/axilioai/apis/axilio-api-2.md) · [All operations](https://skmtc.dev/axilioai/apis/axilio-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/axilioai/axilio-api-2/revisions/d7ecf9466d6d/schema)