Whitelist Number for Test Agent | Pinnacle

Whitelist a phone number for testing with a specific test agent.

During development and testing, RCS agents can only send messages to whitelisted phone numbers. Use this endpoint to whitelist specific phone numbers so you can send and receive messages from the test agent.

Verification Process

After whitelisting, the recipient must accept the tester invite:

The recipient’s device will receive a message from “RBM Tester Management”.
The recipient must tap “Make me a tester” to accept.
Once accepted, the status transitions from PENDING to ACCEPTED.

Verification

Accepting the invite
Accepting the tester invite

Declining the invite
Declining the tester invite

Cooldown

There is a 2-minute cooldown after creating or updating a test agent before you can whitelist numbers. Attempting to whitelist during the cooldown returns a 500 error with the remaining wait time.

Whitelist a phone number for testing with a specific test agent. During development and testing, RCS agents can only send messages to whitelisted phone numbers. Use this endpoint to whitelist specific phone numbers so you can send and receive messages from the test agent. ## Verification Process After whitelisting, the recipient must accept the tester invite: 1. The recipient's device will receive a message from "RBM Tester Management". 2. The recipient must tap "Make me a tester" to accept. 3. Once accepted, the status transitions from `PENDING` to `ACCEPTED`. ## Verification <div style="display: flex; gap: 16px;"> <div style="flex: 1; text-align: center;"> <strong>Accepting the invite</strong><br/> <img src="https://pncl.to/f769cAvCbEx-MmezZjR6dz6KVkr5ZO" alt="Accepting the tester invite" style="max-width: 100%;" /> </div> <div style="flex: 1; text-align: center;"> <strong>Declining the invite</strong><br/> <img src="https://pncl.to/VRere3tEKfx4n0HNaxK-vwl7pbLHTJ" alt="Declining the tester invite" style="max-width: 100%;" /> </div> </div> ## Cooldown There is a **2-minute cooldown** after creating or updating a test agent before you can whitelist numbers. Attempting to whitelist during the cooldown returns a `500` error with the remaining wait time.

Authentication

PINNACLE-API-KEYstring

API Key authentication via header

Path parameters

agentIdstringRequiredformat: "^agent_.*"

The RCS agent ID (must be prefixed with agent_).

Request

This endpoint expects an object.

phoneNumberstringRequiredformat: "^\+[1-9]\d{9,14}$"

Phone number to whitelist for testing in E.164 format.

Response

Returns the whitelist status of the phone number.

statusenum

Status of a whitelisted phone number for RCS testing.

PENDING — The tester invite has been sent but the recipient has not yet accepted or rejected it.
ACCEPTED — The recipient accepted the tester invite and can send/receive messages with the test agent.
REJECTED — The recipient rejected the tester invite or the invite could not be delivered.

Status of a whitelisted phone number for RCS testing. - `PENDING` — The tester invite has been sent but the recipient has not yet accepted or rejected it. - `ACCEPTED` — The recipient accepted the tester invite and can send/receive messages with the test agent. - `REJECTED` — The recipient rejected the tester invite or the invite could not be delivered.

Allowed values:

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error