Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14109583546.7 KB

You can only send messages to verified destination numbers when your account is in the sandbox. You can add up to 10 verified destination numbers.

post/#X-Amz-Target=PinpointSMSVoiceV2.CreateVerifiedDestinationNumber

Headers

X-Amz-Target'PinpointSMSVoiceV2.CreateVerifiedDestinationNumber' required

Request body

DestinationPhoneNumberstring required

The verified destination phone number, in E.164 format.

RcsAgentIdstring

The unique identifier of the RCS agent to associate with the verified destination number. You can use either the RcsAgentId or RcsAgentArn.

ClientTokenstring

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you don't specify a client token, a randomly generated token is used for the request to ensure idempotency.

Response

Success

VerifiedDestinationNumberArnstring required

The Amazon Resource Name (ARN) for the verified destination phone number.

VerifiedDestinationNumberIdstring required

The unique identifier for the verified destination phone number.

DestinationPhoneNumberstring required

The verified destination phone number, in E.164 format.

Status'PENDING' | 'VERIFIED' | 'UNSUPPORTED' required
<p>The status of the verified destination phone number.</p> <ul> <li> <p> <code>PENDING</code>: The phone number hasn't been verified yet.</p> </li> <li> <p> <code>VERIFIED</code>: The phone number is verified and can receive messages.</p> </li> </ul>
RcsAgentIdstring

The unique identifier of the RCS agent associated with the verified destination number.

CreatedTimestampstring date-time required

The time when the verified phone number was created, in <a href="https://www.epochconverter.com/">UNIX epoch time</a> format.