Creating an Email Subscription

Create an email subscription in Notifications to receive notifications by email.

  • 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 Topics Details page, in the Subscription OCID column, click the link for the subscription that you want.
    5. In the Create Subscription panel, for Protocol, select Email.
    6. Enter an email address.
    7. Click Create.

    Notifications creates the email subscription and sends a confirmation URL to the email address. The subscription is pending until confirmation is received.

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

    oci ons subscription create --protocol "EMAIL" --subscription-endpoint <email_address> [...]

    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 email subscription.

    Example:

    POST /20181201/subscriptions
    Host: notification.us-phoenix-1.oraclecloud.com
    <authorization and other headers>
    {
      "topicId": "<topic_OCID>",
      "compartmentId": "<compartment_OCID>",
      "protocol": "EMAIL",
      "endpoint": "john.smith@example.com"
    }

What's Next

To activate the new subscription, navigate to the confirmation URL that was sent to the email address.

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.