---
title: "Add an RCS agent test device"
method: POST
path: "/rcs/agents/{id}/test_devices"
tags: ["RCS Agents"]
---

# Add an RCS agent test device

`POST /rcs/agents/{id}/test_devices`

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.

## Path parameters

- `id` string, uuid, required

## Request body

- TestDeviceCreateRequest
  - `phone_number` string, required

## Response `201`

The test device was added or already existed.

- TestDeviceResponse
  - `invite_status` 'PENDING' | 'ACCEPTED' | 'DECLINED', required
  - `phone_number` string, required
  - `test_device_id` string, uuid, required

## Other responses

- `401` — The request is not authenticated.
- `404` — The resource does not exist, is not owned by the organization, or the provider does not support the requested capability.
- `409` — The operation is not allowed in the current lifecycle state or the idempotency key was used for a different request.
- `422` — The request body or parameters failed validation.
- `502` — The RCS provider rejected or could not complete the request.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)