latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-201,3412,1385.0 MB

3fdc16374d70

RCS Agents

Add an RCS agent test device

Adds an RCS-capable test number after provider agent creation. Repeating the request for a number already attached to the agent returns the existing test device.

post/rcs/agents/{id}/test_devices

Path parameters

idstring uuid required

The Telnyx-assigned agent identifier.

Request body

phone_numberstring required

Example request

{
  "phone_number": "+13125550123"
}

Response

The test device was added or already existed.

invite_status'PENDING' | 'ACCEPTED' | 'DECLINED' required
phone_numberstring required
test_device_idstring uuid required

Example response

{
  "invite_status": "ACCEPTED",
  "phone_number": "+13125550123",
  "test_device_id": "44444444-4444-4444-8444-444444444444"
}