Sign in
conversations

Add Phone To Conversation

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.

post/conversations/{conversation_id}/phones

Path parameters

conversation_idstring uuid required

Request body

phonestring required

New phone number in any common US format

Response

Successful Response

addedboolean required

False if the number was already known (idempotent)

phonestring required

Normalized 10-digit number that was added

Changes

No recorded changes to this endpoint across all 23 revisions of this API.