View a Webhooks Subscription

Endpoint URL: {identityDomain} /{customerId} /webhooks/subscriptions/{subscriptionId}

Description

Returns information about the specified webhooks subscription. Webhook subscriptions determine the event types that trigger near real-time notifications: when one of these events occurs, a webhooks notification is sent to a listener endpoint created and maintained by the organization associated with the subscription.

The base URL for this endpoint is your Identity Cloud API URL, including the appropriate region. For example, if you are in the US region, then your base URL will look like this:

If you are in the Australian (AU) region your base URL will look like this:

Note that the Webhooks v3 APIs all have an API response timeout of 10 seconds.

Respects the API Client Allow List: No

Authentication

This endpoint requires token-based authentication. To obtain an access token, you must use a confidential client (using the client ID as the username and the client secret as the password) to access the /{customerId}/login/token endpoint. The access token returned from that endpoint is then used in the Authorization header of your API call. For example, if you get back the access token 03v-eeodppPrrHXXIx56pRLyDBaOldDxqEwI59MFCFGVuSkLRapzgmfwmEHyKWle then your Authorization header will look like this when using Curl:

In Postman, set the Authorization Type to Bearer and use the access token as the value of the Token field.

URL path parameters

Request Parameters

No additional parameters are required to call this endpoint.

Sample Request (curl)

The following command returns information about the webhooks subscription with the subscription ID 454fe969-1909-4e93-b552-674d47eafdb0:

curl -X GET \
  https://v1.api.us.janrain.com/00000000-0000-0000-0000-000000000000/webhooks/subscriptions/454fe969-1909-4e93-b552-674d47eafdb0 \
  -H 'Authorization: Bearer Xk7EzdpGq5GPQcsxCWM2SxdlwU_iTsA4i2Px4TEzBrfLIvddjnDVBJxjPDuCARHH' 

Responses

200 OK

If your call to this endpoint succeeds, you'll get back detailed information about the specified webhooks subscription:

{
    "subscriptionId": "454fe969-1909-4e93-b552-674d47eafdb0",
    "customerId": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2020-01-27T16:53:36.309183Z",
    "updatedAt": "2020-01-27T16:53:36.309183Z",
    "title": "Gregs test subscription",
    "endpoint": "https://webhook.site/46ff3c5e-ae95-43df-b32d-d07bb84746b4",
    "events": [
        "entityCreated",
        "entityUpdated",
        "entityDeleted"
    ],
    "enabled": true,
    "_links": {
        "self": {
            "href": "/00000000-0000-0000-0000-000000000000/webhooks/subscriptions/454fe969-1909-4e93-b552-674d47eafdb0"
        }
    }
}
 

Error Response Codes

The following table includes information about some of the other response codes that you might encounter when calling this endpoint.