Skip to content
Developer docsChannel Automation Developers
First requestVisit website ↗
Navigation

Save RCS configuration self-serve (workspace admin)

Lets a workspace admin enter their own Twilio RCS details (Messaging Service SID, RCS sender ID, SMS fallback number, test device) once the RCS_MESSAGING feature flag is enabled for the workspace. Self-serve go-live: on save the row is upserted with enabled=true and status='test' (status='approved' is preserved if already set), so RCS starts sending immediately without a platform-owner step. Blocked (403) if the feature flag is off — a workspace cannot self-configure RCS it hasn't been granted. The write uses the service role after the admin check; no Twilio auth tokens are stored here.

PUT
https://api.channelautomation.com/api/rcs/workspaces/{workspaceId}/client-config

Authorization

  • BearerAuth
    HTTP Bearer (JWT)
    required

Path parameters

  • workspaceId
    string
    required

Request body JSON required

  • messagingServiceSid
    string
    required

    Twilio Messaging Service SID (MG…)

  • rcsSenderId
    optional
    string

    Approved RCS Sender ID (optional)

  • fallbackFromPhone
    optional
    string

    E.164 SMS/MMS fallback sender (optional)

  • testDevicePhone
    optional
    string

    E.164 test device for validation (optional)

  • enabled
    optional
    boolean

    Master on/off. Defaults true; false pauses RCS (status=disabled).

  • agentRepliesRcsEnabled
    optional
    boolean

    Agents may start RCS from Text Messages / Board chat. False = SMS for a tagged audience; all-contact audiences retain the RCS inbound reply exception. Omit to keep the current value.

  • eligibilityTagId
    optional
    string
    or null

    Only contacts with this workspace tag may use RCS. Null restores all contacts. Omit to preserve the current audience.

    format: uuid
  • automationsRcsEnabled
    optional
    boolean

    Sequences, flows, question nodes and AI follow-ups send RCS-first. Omit to keep the current value.

Returns

200

Saved config.

400

Invalid Messaging Service SID, phone format, or tag not in this workspace.

401

Authentication required
JSON
  • error
    optional
    string
  • success
    optional
    boolean

403

Workspace admin access required, or RCS not enabled for this workspace.

500

Internal server error
JSON
  • error
    optional
    string
  • details
    optional
    string
  • success
    optional
    boolean

503

Identity or workspace access verification is temporarily unavailable.

Type to search…

↑↓ navigate↵ selectEsc close