Amazon SNS Sns Sms Sandbox Phone Number API
The Sns Sms Sandbox Phone Number API from Amazon SNS — 3 operation(s) for sns sms sandbox phone number.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/amazon-sns:amazon-sns-sms-sandbox-phone-number-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Amazon Simple Notification Service Sms Sandbox Phone Number…
version: '2010-03-31'
description: Generated from AWS's published Smithy model for Amazon Simple Notification Service. 3 operation(s).
contact:
name: Amazon Web Services
url: https://aws.amazon.com/contact-us/
license:
name: Apache 2.0
identifier: Apache-2.0
url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://sns.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
tags:
- name: Sms Sandbox Phone Number
paths:
/?Action=CreateSMSSandboxPhoneNumber:
post:
operationId: CreateSMSSandboxPhoneNumber
summary: Create SMSSandbox Phone Number
description: Adds a destination phone number to an Amazon Web Services account in the SMS sandbox and sends a one-time password (OTP) to that phone number. When you start using Amazon SNS to send SMS messages, your Amazon Web Services account is in the SMS sandbox. The SMS sandbox provides a safe environment for you to try Amazon SNS features without risking your reputation as an SMS sender. While your Amazon Web Services account is in the SMS sandbox, you can use all of the features of Amazon SNS. However, you can send SMS messages only to verified destination phone numbers. For more information, including how to move out of the sandbox to send messages without restrictions, see SMS sandbox in the Amazon SNS Developer Guide.
responses:
'200':
description: Success
content:
text/xml:
schema:
$ref: '#/components/schemas/CreateSMSSandboxPhoneNumberResult'
'403':
description: AuthorizationErrorException
content:
text/xml:
schema:
$ref: '#/components/schemas/AuthorizationErrorException'
'500':
description: InternalErrorException
content:
text/xml:
schema:
$ref: '#/components/schemas/InternalErrorException'
'400':
description: InvalidParameterException; OptedOutException; UserErrorException
content:
text/xml:
schema:
$ref: '#/components/schemas/InvalidParameterException'
'429':
description: ThrottledException
content:
text/xml:
schema:
$ref: '#/components/schemas/ThrottledException'
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
allOf:
- type: object
required:
- Action
- Version
properties:
Action:
type: string
const: CreateSMSSandboxPhoneNumber
Version:
type: string
const: '2010-03-31'
- $ref: '#/components/schemas/CreateSMSSandboxPhoneNumberInput'
tags:
- Sms Sandbox Phone Number
/?Action=DeleteSMSSandboxPhoneNumber:
post:
operationId: DeleteSMSSandboxPhoneNumber
summary: Delete SMSSandbox Phone Number
description: Deletes an Amazon Web Services account's verified or pending phone number from the SMS sandbox. When you start using Amazon SNS to send SMS messages, your Amazon Web Services account is in the SMS sandbox. The SMS sandbox provides a safe environment for you to try Amazon SNS features without risking your reputation as an SMS sender. While your Amazon Web Services account is in the SMS sandbox, you can use all of the features of Amazon SNS. However, you can send SMS messages only to verified destination phone numbers. For more information, including how to move out of the sandbox to send messages without restrictions, see SMS sandbox in the Amazon SNS Developer Guide.
responses:
'200':
description: Success
content:
text/xml:
schema:
$ref: '#/components/schemas/DeleteSMSSandboxPhoneNumberResult'
'403':
description: AuthorizationErrorException
content:
text/xml:
schema:
$ref: '#/components/schemas/AuthorizationErrorException'
'500':
description: InternalErrorException
content:
text/xml:
schema:
$ref: '#/components/schemas/InternalErrorException'
'400':
description: InvalidParameterException; UserErrorException
content:
text/xml:
schema:
$ref: '#/components/schemas/InvalidParameterException'
'404':
description: ResourceNotFoundException
content:
text/xml:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'429':
description: ThrottledException
content:
text/xml:
schema:
$ref: '#/components/schemas/ThrottledException'
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
allOf:
- type: object
required:
- Action
- Version
properties:
Action:
type: string
const: DeleteSMSSandboxPhoneNumber
Version:
type: string
const: '2010-03-31'
- $ref: '#/components/schemas/DeleteSMSSandboxPhoneNumberInput'
tags:
- Sms Sandbox Phone Number
/?Action=ListSMSSandboxPhoneNumbers:
post:
operationId: ListSMSSandboxPhoneNumbers
summary: List SMSSandbox Phone Numbers
description: Lists the calling Amazon Web Services account's current verified and pending destination phone numbers in the SMS sandbox. When you start using Amazon SNS to send SMS messages, your Amazon Web Services account is in the SMS sandbox. The SMS sandbox provides a safe environment for you to try Amazon SNS features without risking your reputation as an SMS sender. While your Amazon Web Services account is in the SMS sandbox, you can use all of the features of Amazon SNS. However, you can send SMS messages only to verified destination phone numbers. For more information, including how to move out of the sandbox to send messages without restrictions, see SMS sandbox in the Amazon SNS Developer Guide.
responses:
'200':
description: Success
content:
text/xml:
schema:
$ref: '#/components/schemas/ListSMSSandboxPhoneNumbersResult'
'403':
description: AuthorizationErrorException
content:
text/xml:
schema:
$ref: '#/components/schemas/AuthorizationErrorException'
'500':
description: InternalErrorException
content:
text/xml:
schema:
$ref: '#/components/schemas/InternalErrorException'
'400':
description: InvalidParameterException
content:
text/xml:
schema:
$ref: '#/components/schemas/InvalidParameterException'
'404':
description: ResourceNotFoundException
content:
text/xml:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'429':
description: ThrottledException
content:
text/xml:
schema:
$ref: '#/components/schemas/ThrottledException'
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
allOf:
- type: object
required:
- Action
- Version
properties:
Action:
type: string
const: ListSMSSandboxPhoneNumbers
Version:
type: string
const: '2010-03-31'
- $ref: '#/components/schemas/ListSMSSandboxPhoneNumbersInput'
tags:
- Sms Sandbox Phone Number
components:
schemas:
DeleteSMSSandboxPhoneNumberResult:
type: object
properties: {}
SMSSandboxPhoneNumber:
type: object
properties:
PhoneNumber:
type: string
description: The destination phone number.
Status:
type: string
enum:
- Pending
- Verified
description: The destination phone number's verification status.
CreateSMSSandboxPhoneNumberInput:
type: object
properties:
PhoneNumber:
type: string
description: The destination phone number to verify. On verification, Amazon SNS adds this phone number to the list of verified phone numbers that you can send SMS messages to.
LanguageCode:
type: string
enum:
- en-US
- en-GB
- es-419
- es-ES
- de-DE
- fr-CA
- fr-FR
- it-IT
- ja-JP
- pt-BR
- kr-KR
- zh-CN
- zh-TW
description: The language to use for sending the OTP. The default value is en-US.
required:
- PhoneNumber
DeleteSMSSandboxPhoneNumberInput:
type: object
properties:
PhoneNumber:
type: string
description: The destination phone number to delete.
required:
- PhoneNumber
ListSMSSandboxPhoneNumbersInput:
type: object
properties:
NextToken:
type: string
description: Token that the previous ListSMSSandboxPhoneNumbersInput request returns.
MaxResults:
type: integer
description: The maximum number of phone numbers to return.
CreateSMSSandboxPhoneNumberResult:
type: object
properties: {}
ThrottledException:
type: object
properties:
message:
type: string
description: Throttled request.
ResourceNotFoundException:
type: object
properties:
message:
type: string
InternalErrorException:
type: object
properties:
message:
type: string
ListSMSSandboxPhoneNumbersResult:
type: object
properties:
PhoneNumbers:
type: array
items:
$ref: '#/components/schemas/SMSSandboxPhoneNumber'
description: A list of the calling account's pending and verified phone numbers.
NextToken:
type: string
description: A NextToken string is returned when you call the ListSMSSandboxPhoneNumbersInput operation if additional pages of records are available.
required:
- PhoneNumbers
AuthorizationErrorException:
type: object
properties:
message:
type: string
InvalidParameterException:
type: object
properties:
message:
type: string
securitySchemes:
sigv4:
type: apiKey
in: header
name: Authorization
description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
x-aws-sigv4:
signingName: sns
x-provenance:
method: harvested
publisher: Amazon Web Services
source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/sns/service/2010-03-31/sns-2010-03-31.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)