docs.aws.amazon.com
Open in
urlscan Pro
18.66.139.67
Public Scan
URL:
https://docs.aws.amazon.com/sns/latest/dg/channels-sns-sms-tfn-register.html
Submission: On August 09 via api from US — Scanned from DE
Submission: On August 09 via api from US — Scanned from DE
Form analysis 0 forms found in the DOM
Text Content
SELECT YOUR COOKIE PREFERENCES
We use cookies and similar tools to enhance your experience, provide our
services, deliver relevant advertising, and make improvements. Approved third
parties also use these tools to help us deliver advertising and provide certain
site features.
CustomizeAccept all
CUSTOMIZE COOKIE PREFERENCES
We use cookies and similar tools (collectively, "cookies") for the following
purposes.
ESSENTIAL
Essential cookies are necessary to provide our site and services and cannot be
deactivated. They are usually set in response to your actions on the site, such
as setting your privacy preferences, signing in, or filling in forms.
PERFORMANCE
Performance cookies provide anonymous statistics about how customers navigate
our site so we can improve site experience and performance. Approved third
parties may perform analytics on our behalf, but they cannot use the data for
their own purposes.
Allow performance category
Allowed
FUNCTIONAL
Functional cookies help us provide useful site features, remember your
preferences, and display relevant content. Approved third parties may set these
cookies to provide certain site features. If you do not allow these cookies,
then some or all of these services may not function properly.
Allow functional category
Allowed
ADVERTISING
Advertising cookies may be set through our site by us or our advertising
partners and help us deliver relevant marketing content. If you do not allow
these cookies, you will experience less relevant advertising.
Allow advertising category
Allowed
Blocking some types of cookies may impact your experience of our sites. You may
review and change your choices at any time by clicking Cookie preferences in the
footer of this site. We and selected third-parties use cookies or similar
technologies as specified in the AWS Cookie Notice
.
CancelSave preferences
English
Sign In to the Console
1. AWS
2. ...
3. Documentation
4. Amazon Simple Notification Service
5. Developer Guide
Feedback
Preferences
Amazon Simple Notification Service
Developer Guide
* What is Amazon SNS?
* Features and capabilities
* Related services
* Accessing Amazon SNS
* Pricing for Amazon SNS
* Common Amazon SNS scenarios
* Working with AWS SDKs
* Amazon SNS event sources and destinations
* Event sources
* Event destinations
* Setting up
* Getting started
* Configuring Amazon SNS
* Creating a topic
* Subscribing to a topic
* Deleting a subscription and topic
* Tagging
* Configuring tags
* Message ordering and deduplication (FIFO topics)
* FIFO topics use case
* Message ordering details
* Message grouping
* Message delivery
* Message filtering
* Message deduplication
* Message security
* Message durability
* Code examples
* Message publishing
* Large message payloads
* Message attributes
* Message batching
* Message filtering
* Subscription filter policies
* Example filter policies
* Filter policy constraints
* Attribute string value matching
* Attribute numeric value matching
* Attribute key matching
* AND/OR logic
* Applying a subscription filter policy
* Removing a subscription filter policy
* Message delivery
* Raw message delivery
* Cross-account delivery
* Cross-region delivery
* Message delivery status
* Message delivery retries
* Dead-letter queues (DLQs)
* Configuring a dead-letter queue
* Message archiving and analytics
* Application-to-application (A2A) messaging
* Fanout to Kinesis Data Firehose delivery streams
* Prerequisites
* Subscribing a delivery stream to a topic
* Delivery stream destinations
* Amazon S3 destinations
* Archived message format
* Analyzing messages
* OpenSearch Service destinations
* Archived message format
* Analyzing messages
* Amazon Redshift destinations
* Archive table structure
* Analyzing messages
* HTTP destinations
* Delivered message format
* Example use case
* Creating the initial resources
* Creating the delivery stream
* Subscribing the delivery stream to the topic
* Testing and querying
* Example (AWS CloudFormation)
* Fanout to Lambda functions
* Prerequisites
* Subscribing a function to a topic
* Fanout to Amazon SQS queues
* Subscribing a queue to a topic
* Example (AWS CloudFormation)
* Fanout to HTTP/S endpoints
* Subscribing an endpoint to a topic
* Make sure your endpoint is ready to process messages
* Subscribe the HTTP/HTTPS endpoint to the topic
* Confirm the subscription
* Set the delivery retry policy for the subscription
* Give users permissions to publish to the topic
* Send messages to the HTTP/HTTPS endpoint
* Verifying message signatures
* Parsing message formats
* Fanout to AWS Event Fork Pipelines
* Deploying and testing AWS Event Fork Pipelines
* Example AWS Event Fork Pipelines use case
* To deploy the sample application
* To execute the sample application
* To verify the execution of the sample application and its pipelines
* To simulate an issue and replay events for recovery
* Subscribing an event pipeline to a topic
* To deploy and subscribe the event storage and backup pipeline
* To deploy and subscribe the event search and analytics pipeline
* To deploy and subscribe the event replay pipeline
* Application-to-person (A2P) messaging
* Mobile text messaging (SMS)
* SMS sandbox
* Adding and verifying phone numbers
* Deleting phone numbers
* Moving out of the SMS sandbox
* Origination identities
* Sender IDs
* Origination numbers
* 10DLC
* Registering a company
* Editing or deleting a registered company
* Registering a 10DLC campaign
* Editing or deleting a 10DLC campaign
* Associating a long code with a 10DLC campaign
* 10DLC cross-account access
* Getting information about 10DLC registration issues
* Toll-free numbers
* Toll-free number registration requirements and process
* Short codes
* Person-to-person (P2P) long codes
* Requesting SMS support
* Requesting short codes
* Requesting 10DLC numbers, toll-free numbers, and P2P long codes
* Requesting sender IDs
* Requesting spending quota increases
* Setting SMS preferences
* Sending SMS messages
* Publishing to a topic
* Publishing to a mobile phone
* Monitoring SMS activity
* Viewing delivery statistics
* Viewing CloudWatch metrics and logs
* Viewing usage reports
* Managing SMS subscriptions
* Supported Regions and countries
* SMS best practices
* SMS requirements for Singapore
* SMS requirements for US destinations
* SMS requirements for India
* Sending SMS messages to India: task overview
* Step 1: Registering with the TRAI
* Step 2: Requesting a sender ID
* Step 3: Sending SMS messages
* Troubleshooting SMS messages sent to recipients in India
* Mobile push notifications
* Setting up a mobile app
* Prerequisites
* Creating a platform application
* Creating a platform endpoint
* Adding device tokens or registration IDs
* Apple authentication methods
* Sending mobile push notifications
* Publishing to a topic
* Publishing to a mobile device
* Publishing with platform-specific payload
* Mobile app attributes
* Mobile app events
* Mobile push API actions
* Mobile push API errors
* Mobile push TTL
* Supported Regions
* Mobile push notifications best practices
* Email notifications
* Code examples
* Actions
* Add tags to a topic
* Check whether a phone number is opted out
* Confirm an endpoint owner wants to receive messages
* Create a topic
* Delete a subscription
* Delete a topic
* Get the properties of a topic
* Get the settings for sending SMS messages
* List opted out phone numbers
* List the subscribers of a topic
* List topics
* Publish an SMS text message
* Publish to a topic
* Set a dead-letter queue for a subscription
* Set a filter policy
* Set the default settings for sending SMS messages
* Set topic attributes
* Subscribe a Lambda function to a topic
* Subscribe a mobile application to a topic
* Subscribe an HTTP endpoint to a topic
* Subscribe an email address to a topic
* Scenarios
* Create a platform endpoint for push notifications
* Create and publish to a FIFO topic
* Publish SMS messages to a topic
* Publish a large message
* Cross-service examples
* Build an app to submit data to a DynamoDB table
* Building an Amazon SNS application
* Create an Amazon Textract explorer application
* Detect people and objects in a video
* Use API Gateway to invoke a Lambda function
* Use scheduled events to invoke a Lambda function
* Security
* Data protection
* Data encryption
* Encryption at rest
* Key management
* Enabling SSE for a topic
* Enabling SSE for a topic with an encrypted queue subscribed
* Internetwork traffic privacy
* Creating a VPC endpoint
* Creating a VPC policy
* Publishing a message from a VPC
* Identity and access management
* Overview
* When to use access control
* Key concepts
* Architectural overview
* Using the Access Policy Language
* Evaluation logic
* Example cases for Amazon SNS access control
* Using identity-based policies
* Using temporary credentials
* API permissions reference
* Logging and monitoring
* Logging API calls using CloudTrail
* Monitoring topics using CloudWatch
* Compliance validation
* Resilience
* Infrastructure security
* Best practices
* Troubleshooting
* Documentation history
* AWS glossary
Toll-free number registration requirements and process - Amazon Simple
Notification Service
AWSDocumentationAmazon Simple Notification ServiceDeveloper Guide
Toll-free number forbidden use casesRegistering your toll-free number
TOLL-FREE NUMBER REGISTRATION REQUIREMENTS AND PROCESS
PDFRSS
Important
US mobile carriers have recently changed their regulations, and will require
that all toll-free numbers (TFNs) complete a registration process with a
regulatory body before September 30, 2022. If you currently have a toll-free
number you must register your toll-free number by September 30, 2022 or you will
no longer be able to use the toll-free number. You can check the status of your
number by going to Toll-free number registration status. For more information
about registering your company see Registering your toll-free number.
It can take up to 15 business days for your registration to be processed after
it is submitted.
You can use toll-free phone numbers (TFN) to deliver Amazon SNS messages to
recipients in the US. After you request a TFN, you can use it to register your
company. Each TFN requires a single specific use case to use with it. For
example, if you register a TFN to use for one time passwords, it can only be
used for sending one time passwords. A TFN can be revoked if it is used for
anything other then the specified use case.
For guidelines on using TFNs, as well as their advantages and disadvantages, see
Toll-free numbers.
TOLL-FREE NUMBER FORBIDDEN USE CASES
Amazon SNS is has limited ability to send messages in cases where the messages
are blocked (controlled substance, phishing), or when high levels of filtering
are expected (high-risk financial). Amazon SNS cannot guarantee registering any
use cases defined in Guidelines for using toll-free numbers.
REGISTERING YOUR TOLL-FREE NUMBER
After you've purchased a TFN (using the steps in Requesting a phone number in
the Amazon Pinpoint console), you must then register the number.
Topics
* Manual form-based registration process for toll-free numbers in regions other
than Amazon Pinpoint regions
* Self-serve registration for toll-free numbers in Amazon Pinpoint regions
* Toll-free number registration status
* Editing a toll-free number registration
* Deleting a toll-free number registration
* Toll-free number frequently asked questions
MANUAL FORM-BASED REGISTRATION PROCESS FOR TOLL-FREE NUMBERS IN REGIONS OTHER
THAN AMAZON PINPOINT REGIONS
1. Use the following example registration form to complete the required
information in the toll-free number registration template. To download the
CSV template, choose US_TFN_Registration.zip.
Each registration request or use case can only have five TFNs. If you
believe you qualify for an exemption to this rule, provide a detailed
explanation for consideration. List all phone numbers associated with the
registration or use case.
2. Create a case with AWS Support. Attach your completed CSV template to the
case, and submit the TFN registration request.
Key point to note
1. Registrations can take up to two weeks to process once all the required
information has been submitted. If information is missing or incomplete, the
registration process will be delayed. If your registration is rejected,
we'll work with you to figure out why it was denied, and suggest methods to
improve your campaign so that it can be registered.
2. TFNs work well for transactional uses cases such as multi-factor
authentication (MFA) where limited throughput is required. Each TFN can send
up to three text messages parts per second, and each customer account can
have up to five TFNs. If you are sending over 15 text messages parts per
second but less than 100, we recommend you register one or more 10DLC
origination IDs. If your use cases require sending more than 100 text
messages per second, we recommend you purchase and register one or more
short codes. For more details, see Guidelines for using toll-free numbers.
SELF-SERVE REGISTRATION FOR TOLL-FREE NUMBERS IN AMAZON PINPOINT REGIONS
If you've requested the toll-free number in the Amazon Pinpoint regions, you can
complete the company registration process directly in the Amazon Pinpoint
console. When registering your TFN, make sure the information is complete and
accurate or your registration can be rejected. The information that you enter
should be an exact match for the company information that's associated with the
tax ID of your US corporate head quarters.
To register a toll-free number
1. Before you can register, you have to purchase the toll-free number by
following the directions in Toll-free numbers.
2. Sign in to the AWS Management Console and open the Amazon Pinpoint console
at https://console.aws.amazon.com/pinpoint/.
3. In the navigation pane, under SMS and voice, choose Phone numbers.
4. On the Toll-free registrations tab, choose the Toll-free Phone number you
want to register then Create registration.
5. In the Company Information section, do the following:
* For Company Name, enter the name that the company is registered under.
The name that you enter must be an exact match for the company name
that's associated with the tax ID that you provide.
* For Company Website, enter the URL for your company's website.
* For Address 1, enter the street address of your US corporate
headquarters.
* For Address 2 - optional, if needed enter suite number of your US
corporate headquarters.
* For City, enter the city of your US corporate headquarters.
* For State, enter the state of your US corporate headquarters.
* For Zip Code, enter the zip code of your US corporate headquarters.
* For Country, enter the two digit IDO country code.
6. In the Contact Information section, do the following:
* For First Name, enter the first name of the person who will be your
business's point of contact.
* For Last Name, enter the last name of the person who will be your
business's point of contact.
* For Support Email, enter the email address of the person who will be your
business's point of contact.
* For Support Phone Number, enter the phone number of the person who will
be your business's point of contact.
7. In the Messaging Use Case section, do the following:
* For Monthly SMS Volume select the number of SMS messages that will be
each month.
* For Use Case Category select one of the following use case types that the
number will be used for:
* Two-factor authentication – Use this for sending two factor
authentication codes.
* One-time passwords – Use this for sending a user a one time password.
* Notifications – Use this if you only intend to send your users
important notifications.
* Polling and surveys – Use this to poll users on their preferences.
* Info on demand – This is for sending users messages after they have
sent a request.
* Promotions and Marketing – Use this if you only intend to send
marketing messages to your users.
* Other – Use this if your use case doesn't fall into any other
category. If you use this, fill out the Use Case Details
field.
* For Use Case Details – optional you can use this field to give more
context to the selected Use Case Category.
* For Opt-in Workflow Description enter a description of how user's will
consent to receive SMS messages. For example did they give consent by
filling out an online form on your website.
* Use Opt-in workflow file to upload an image of how users will be able to
consent to receiving messages. If you need to upload more than one image,
you can use a single zip file. The supported file types are PNG and ZIP.
The maximum file size is 400 KB.
8. In the Messaging Samples section, do the following:
* For Message Sample 1, enter an example message of the SMS message body
that will be sent to your end users.
* For Message Sample 2 – optional and Message Sample 3 – optional, you can
enter note example messages, if needed, of the SMS message body that will
be sent to your end users.
9. Once you've filled out the form, select the Submit registration button.
TOLL-FREE NUMBER REGISTRATION STATUS
After you register a toll-free number, there are five different statuses that
the registration can be in:
* Created – Your registration has been created, but hasn't been submitted yet.
* Reviewing – Your registration has been accepted and is being reviewed. It may
take up to 15 business days for the review to be completed.
* Complete – Your registration has been approved and you can start using the
toll-free number to start sending messages.
* Requires Updates – You need to fix your registration and resubmit it by
following the directions in Editing a toll-free number registration. Fields
that require updates will have a warning icon and a brief description of the
issue.
* Closed – You deleted the toll-free number and need to delete the registration
for the number.
Check your registration status
1. Sign in to the AWS Management Console and open the Amazon Pinpoint console
at.
2. In the navigation pane, under SMS and voice, choose Phone numbers.
3. On the Toll-free registrations tab, choose the Toll-free Phone number.
4. You can then view the registration status of each toll-free number.
EDITING A TOLL-FREE NUMBER REGISTRATION
If there is an issue with the registration after you've submitted it, the
registration status will be set to Requires Updates. You can make changes to the
registration form in this state. Fields that require updates will have a warning
icon and a brief description of the issue.
DELETING A TOLL-FREE NUMBER REGISTRATION
After you've submitted the toll-free number registration, you can delete it. It
is recommend that you delete the toll-free number before the registration.
To delete a registration
1. Open the Amazon Pinpoint console at
https://console.aws.amazon.com/pinpoint/.
2. In the navigation pane, under SMS and voice, choose Phone numbers tabs.
3. On the Toll-free registrations tab, choose the Registration ID you want to
delete, then select the Delete Registration button.
TOLL-FREE NUMBER FREQUENTLY ASKED QUESTIONS
Frequently asked questions about the toll-free number registration process.
To check if you own a toll-free number
* Open the Amazon Pinpoint console at https://console.aws.amazon.com/pinpoint/.
* In the navigation pane, under SMS and voice, choose Phone numbers.
* The toll-free numbers type is listed as toll-free.
DO I CURRENTLY OWN A TOLL-FREE NUMBER?
To check if you own a toll-free number
* Open the Amazon Pinpoint console at https://console.aws.amazon.com/pinpoint/.
* In the navigation pane, under SMS and voice, choose Phone numbers.
* The toll-free numbers type is listed as toll-free.
Yes. If you currently own a toll-free number, you need to register before
September 30, 2022 to continue using it. If you are purchasing a new toll-free
number after September 30, 2022, you must register it before you can send
messages.
DO I HAVE TO REGISTER MY TOLL-FREE NUMBER?
Yes. If you currently own a toll-free number, you need to register before
September 30, 2022 to continue using it. If you are purchasing a new toll-free
number after September 30, 2022, you must register it before you can send
messages.
Follow the directions at Requesting a phone number using the Amazon Pinpoint
console to purchase a toll-free number.
HOW DO I PURCHASE A TOLL-FREE NUMBER?
Follow the directions at Requesting a phone number using the Amazon Pinpoint
console to purchase a toll-free number.
Follow the directions at Registering your toll-free number to register a
toll-free number.
HOW DO I REGISTER MY TOLL-FREE NUMBER?
Follow the directions at Registering your toll-free number to register a
toll-free number.
Follow the directions at Toll-free number registration status to check your
registration and status.
WHAT IS THE REGISTRATION STATUS OF MY TOLL-FREE NUMBER AND WHAT DOES IT MEAN?
Follow the directions at Toll-free number registration status to check your
registration and status.
You will need to provide your company's address, a business contact, and use
case for the toll-free number. You can find the required information at
Registering your toll-free number.
WHAT INFORMATION DO I NEED TO PROVIDE?
You will need to provide your company's address, a business contact, and use
case for the toll-free number. You can find the required information at
Registering your toll-free number.
If your registration is rejected, the status is changed to Requires Updates. To
make updates, see Editing a toll-free number registration.
WHAT IF MY REGISTRATION IS REJECTED?
If your registration is rejected, the status is changed to Requires Updates. To
make updates, see Editing a toll-free number registration.
The IAM user/role you use to visit the Amazon Pinpoint console must have the
“sms-voice:*” permission, otherwise you will get an access denied error.
WHAT PERMISSIONS DO I NEED?
The IAM user/role you use to visit the Amazon Pinpoint console must have the
“sms-voice:*” permission, otherwise you will get an access denied error.
Javascript is disabled or is unavailable in your browser.
To use the Amazon Web Services Documentation, Javascript must be enabled. Please
refer to your browser's Help pages for instructions.
Document Conventions
Toll-free numbers
Short codes
Did this page help you? - Yes
Thanks for letting us know we're doing a good job!
If you've got a moment, please tell us what we did right so we can do more of
it.
Did this page help you? - No
Thanks for letting us know this page needs work. We're sorry we let you down.
If you've got a moment, please tell us how we can make the documentation better.
Did this page help you?
YesNo
Provide feedback
Edit this page on GitHub
Next topic:Short codes
Previous topic:Toll-free numbers
Need help?
* Try AWS re:Post
* Connect with an AWS IQ expert
PrivacySite termsCookie preferences
© 2022, Amazon Web Services, Inc. or its affiliates. All rights reserved.
On this page
--------------------------------------------------------------------------------
* Toll-free number forbidden use cases
* Registering your toll-free number
DID THIS PAGE HELP YOU? - NO
Thanks for letting us know this page needs work. We're sorry we let you down.
If you've got a moment, please tell us how we can make the documentation better.
Feedback