Creating an SMS Subscription

Create an SMS subscription in Notifications.

SMS subscriptions are enabled only for messages sent by the following Oracle Cloud Infrastructure services: Announcements, Monitoring, and Connector Hub. SMS messages sent by unsupported services are dropped. See Cause: Unsupported resource used for SMS.

Message contents and appearance vary by message type. See SMS alarm messages and SMS connector messages.

By providing your phone number, you are opting-in to receive recurring SMS notifications for your organization. Reply STOP to opt-out at any time. Message and data rates may apply.

Before You Begin

If SMS messages come from a phone number in another country, international SMS capabilities are required. We continuously add support for more countries so that more users can receive SMS messages from local phone numbers.

  • These steps show how to open the Create Subscription panel from the details page for the topic that you want to add the subscription to. You can also open this panel from the Subscriptions page, specifying the topic in the panel: Click Create Subscription, and then select a Subscription Topic.

    1. Open the navigation menu and click Developer Services. Under Application Integration, click Notifications.
    2. On the Topics page, select the compartment that contains the topic that you want.
    3. Click the name of the topic that you want to add the subscription to.
    4. On the Topic Details page, click Create Subscription.
    5. In the Create Subscription panel, for Protocol, select SMS.
    6. Select the country for the phone number.
      See the table following these steps.
    7. Enter the phone number, using E.164 format.
      Example: +14255550100
    8. Click Create.

    Notifications creates the SMS subscription and sends a confirmation URL to its endpoint. The subscription is pending until confirmation is received.

  • Use the oci ons subscription create command and required parameters to create an SMS subscription:

    oci ons subscription create --protocol "SMS" --subscription-endpoint <SMS_endpoint> [...]

    For a complete list of parameters and values for CLI commands, see the Command Line Reference for Notifications.

  • Run the CreateSubscription operation to create an SMS subscription.


    POST /20181201/subscriptions
    <authorization and other headers>
      "topicId": "<topic_OCID>",
      "compartmentId": "<compartment_OCID>",
      "protocol": "SMS",
      "endpoint": "<sms-endpoint>"

Available Countries and Regions

You can use Notifications to send SMS messages to the following countries and regions:

Country or region ISO code
Australia AU
Brazil BR
Canada CA
Chile CL
China CN
Costa Rica CR
Croatia HR
Czechia CZ
France FR
Germany DE
Hungary HU
India IN
Ireland IE
Israel IL
Japan JP
Lithuania LT
Mexico MX
Netherlands NL
New Zealand NZ
Norway NO
Philippines PH
Poland PL
Portugal PT
Romania RO
Saudi Arabia SA
Singapore SG
South Africa ZA
South Korea KR
Spain ES
Sweden SE
Switzerland CH
Ukraine UA
United Arab Emirates AE
United Kingdom GB
United States US

What's Next

To activate the new SMS subscription, follow the instructions received on the phone.

Although a new subscription must be in the same compartment as its parent topic, you can move it to another compartment after creation. See Moving a Subscription.