---
title: "Add Phone To Conversation"
method: POST
path: "/conversations/{conversation_id}/phones"
tags: ["conversations"]
---

# Add Phone To Conversation

`POST /conversations/{conversation_id}/phones`

Register a new phone number on a conversation so it can be messaged.

Adds the number to the conversation's known phones (customer_phones), which
both lets outbound sends target it and routes future inbound replies from it
back into this conversation. The number is added to this conversation only —
it is not written to the ServiceTitan customer profile.

After this succeeds, send to the new number via POST /{id}/send with
target_phone set to the returned phone.

## Path parameters

- `conversation_id` string, uuid, required

## Request body

- AddPhoneRequest — Request to register a new phone number on a conversation.
  - `phone` string, required — New phone number in any common US format

## Response `200`

Successful Response

- AddPhoneResponse — Result of registering a phone number on a conversation.
  - `added` boolean, required — False if the number was already known (idempotent)
  - `phone` string, required — Normalized 10-digit number that was added
  - `available_phones` AvailablePhoneResponse[] — Refreshed available-phones list for the conversation
    - `phone` string, required — Phone number (10 digits, normalized)
    - `label` string, required — Display label: 'Primary' or 'Alternate'
    - `is_primary` boolean, required — Whether this is the primary phone number

## Other responses

- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.dev/noso/apis/crucible-backend-api.md) · [All operations](https://skmtc.dev/noso/apis/crucible-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/noso/apis/crucible-backend-api/revisions/8eb1d6b3ce25?raw)