Create Subscription

POST {{baseUrl}}/subscriptions

Creates a subscription for the specified topic and sends a subscription confirmation URL to the endpoint. The subscription remains in Pending status until it has been confirmed. For information about confirming subscriptions, see To confirm a subscription.

The topic endpoint is required for this operation. To get the topic endpoint, use GetTopic and review the apiEndpoint value in the response (NotificationTopic).

Transactions Per Minute (TPM) per-tenancy limit for this operation: 60.

Request Body

{"compartmentId"=>"{{compartment_ocid}}", "endpoint"=>"abc@oracle.com", "protocol"=>"EMAIL", "topicId"=>"ocid1.onstopic.oc1....", "metadata"=>"ut"}

HEADERS

KeyDatatypeRequiredDescription
opc-retry-tokenstringA token that uniquely identifies a request so it can be retried in case of a timeout or
server error without risk of executing that same action again. Retry tokens expire after 24
hours, but can be invalidated before that due to conflicting operations (for example, if a resource
has been deleted and purged from the system, then a retry of the original creation request
may be rejected).
opc-request-idstringThe unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
particular request, please provide the request ID.
Content-Typestring
Datestring(Required) Current Date
Authorizationstring(Required) Signature Authentication on Authorization header
x-content-sha256string(Required) Content sha256 for POST, PUT and PATCH operations

RESPONSES

status: OK

{"compartmentId":"eu Duis ut laborum","endpoint":"el","id":"in amet","lifecycleState":"PENDING","protocol":"EMAIL","topicId":"reprehenderit deserunt","createdTime":-83512598,"deliverPolicy":"nulla proident laboris consequat"}