RCS Agent Registration API

You can now register RCS brands and agents programmatically, from brand verification through carrier launch, via the Telnyx API. The entire lifecycle, from creating the brand and agent basics to submitting campaign and testing evidence for carrier launch, is handled through a single API.

What's new

• Two-stage flow: Create the brand and agent basics, then test on real devices before submitting campaign and testing evidence for carrier launch.
• Use case support: Register agents for MULTI_USE, PROMOTIONAL, TRANSACTIONAL, and OTP use cases.
• Full status tracking: Track agents through every stage: CREATED -> SUBMITTED -> VERIFYING -> VERIFIED -> LAUNCHING -> LAUNCHED -> LIVE.
• Test device management: Add, list, and remove RCS-capable numbers to test on real devices before going live.
• Carrier approval tracking: Monitor per-carrier or aggregate hub status during the launch phase.

Important notes

• Applies to registering RCS agents in the US only.
• API only for now. Full portal UX is coming soon.
• Support for other countries will follow. The manual form fill process remains available for non-US registrations.
• Per-carrier provisioning status is not currently available.

Getting started

1. Create an RCS brand via the API with your brand details.
2. Create an RCS agent under the brand with your chosen use case.
3. Add test device numbers and verify your agent renders correctly on real devices.
4. Submit campaign and testing evidence for carrier launch.
5. Track the status through to LIVE.

curl -X POST https://api.telnyx.com/v2/rcs_agents \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_id": "brand_abc123",
    "name": "My RCS Agent",
    "use_case": "MULTI_USE",
    "description": "Customer support and notifications"
  }'

Learn more in the RCS Agent Registration quickstart or the API reference.