{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/developer/webhooks/sidebars.yaml","oas-api-reference/index.yaml":"oas-api-reference/index.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img","tabs","tab","openapi-code-sample","openapi-response-sample"]},"type":"markdown"},"seo":{"title":"Subscribe to webhooks","siteUrl":"https://docs.wise.com","projectTitle":"Wise Platform","description":"Subscribe to webhooks in Developer Hub or programmatically via the API.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"keywords":["webhook management","subscriptions","events","delivery_attempts","retry event"]},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"subscribe-to-webhooks","__idx":0},"children":["Subscribe to webhooks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wise offers many event types and each event type triggers specific notifications. You must subscribe to each event for which you want to receive notifications."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can subscribe to webhooks in the following ways:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On the Wise ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://wise.com/developer-hub"},"children":["Developer Hub"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Programmatically via API."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Whether you subscribe via Developer Hub or via API, you must provide the following information:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A name for the subscription."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The event type to subscribe to (when subscribing via API, this value goes into the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["trigger_on"]}," field)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your webhook URL that will receive the event notification (IP addresses not allowed)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The schema version for the event type. We always recommend using the latest supported schema version for the event type.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["4.0.0"]}," and later provides consistent millisecond-precision timestamps, which helps with correct ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/developer/webhooks/event-ordering"},"children":["event ordering"]},"."]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If subscribing via API, you must also have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your client key from Developer Hub."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your client credentials access token."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"subscribe-via-developer-hub","__idx":2},"children":["Subscribe via Developer Hub"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With Wise ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://wise.com/developer-hub"},"children":["Developer Hub"]},", you can view the details of active subscriptions, create and delete webhook subscriptions, and see the event history."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Webhooks in the Developer Hub are application-level only and require access  permissions. Speak with your implementation team if you don’t yet have access."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"view-active-subscriptions","__idx":3},"children":["View active subscriptions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Go to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhooks > Subscriptions"]}," section in Developer Hub."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The page displays a list of all subscriptions for the currently selected application with the following information:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"Column"},"children":["Column "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The human-readable name you gave the subscription."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Listening for"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The event type and schema version.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Ex: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transfers#state-change · 4.0.0"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The callback URL where events are delivered."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click any row to go to that subscription's detail page."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/webhooks_subscriptionlist.03d0f21e3d89b2bd7aef953e83df79fd1e8e4dd12d150dcd3e85aa83958ae91d.34ceb4a1.png","alt":"Developer hub webhook subscriptions page","withLightbox":true,"border":"1px solid lightgrey"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-subscription","__idx":4},"children":["Create a subscription"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the Webhook Subscriptions page, click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Subscription"]}," button."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Create Subscription form appears and includes four ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["required"]}," sections:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Subscription name"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Notification URL"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Listen for"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Schema version"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/webhooks_createsubscription.995d6b9cbd1d330b54134eb778ed9f69da57c51707fa0da0e46f2dd8b6091380.34ceb4a1.png","alt":"Developer hub create subscription form page","withLightbox":true,"border":"1px solid lightgrey"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Section"},"children":["Section"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Subscription name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is your label to identify this subscription. The name pre-fills with a default value based on how many subscriptions already exist (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Subscription 3"]},"). ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Change this value to anything you prefer, just make sure it is unique."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Notification URL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is the HTTPS endpoint that will receive webhook payloads. The URL is validated in real time. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The URL must meet ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["all"]}," of the following requirements:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Must start with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://"]}," (related error: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["The URL must be valid and start with 'https://'"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Must not include an explicit port number (related error: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["The URL must not include a port number"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Must not include query parameters (related error: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["The URL must not include any query parameters"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Must not include user credentials (related error: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["The URL must not include user credentials"]},") ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Example of a valid URL: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://my-webhook-domain.com/callback"]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Listen for"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is a grouped, collapsible list of available event types.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"At this time, you can select ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["exactly one event type per subscription"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Schema version"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This section appears after you select an event type. A dropdown lists all available schema versions for the selected event type, most recent first."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you have completed the form, click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Subscription"]}," button."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Creating a subscription automatically sends a test event to your callback URL so you can verify your endpoint is reachable."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"view-subscription-detail","__idx":5},"children":["View subscription detail"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click any row in the subscriptions table to open the detail page for that subscription."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The detail page shows:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Listening for"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The event type and schema version."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Subscription ID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The unique identifier for this subscription (useful for API calls)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["URL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The callback URL."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Created at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The date the subscription was created."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Recent events table"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The delivery history scoped to this subscription. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/developer/webhooks/view-retry-events#event-delivery-details"},"children":["Event Delivery Details"]}," for how to use it."]}]}]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/webhooks_subscriptiondetails.f0fd454c8d4e8060d782fe390c8822b4fc0d93c01e38476a3309e5d18ce82392.34ceb4a1.png","alt":"Developer hub subscription details page","withLightbox":true,"border":"1px solid lightgrey"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"delete-a-subscription","__idx":6},"children":["Delete a subscription"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the subscription's detail page, click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delete subscription"]}," button. A confirmation modal appears with the message:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Any events in flight at the time of deletion are still delivered but no webhook will be sent for them as the subscription no longer exists."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"subscribe-via-api","__idx":7},"children":["Subscribe via API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To subscribe to a webhook event via API, send a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/webhook/webhookapplicationsubscriptioncreate"},"children":["create application webhook subscription request"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each request creates a subscription for a specific event. You must create a subscription for every event for which you want to receive notifications."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-body","__idx":8},"children":["Request body"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All of the following fields are required in the request body:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"Field"},"children":["Field "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your custom name for the subscription. Names should be unique and descriptive."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["trigger_on"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The event type value of the webhook you are subscribing to. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/webhook-event"},"children":["list of available webhook events"]}," along with their details and example payloads.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Examples: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transfers#state-change"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transfers#refund"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["balances#update"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["profiles#state-change"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the schema ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["version"]}," and your callback ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}," where notification payloads are sent."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery.version"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The schema version of the event. We recommend always using the latest version."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery.url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The URL where your server will be listening for events."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request-and-response","__idx":9},"children":["Example request and response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following examples show a request and response for a subscription to the transfer state change event (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transfers#state-change"]},")."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Request","disable":false},"children":[{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-api-reference/index.yaml","operationId":"webhookApplicationSubscriptionCreate","parameters":{},"environments":{}},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Response","disable":false},"children":[{"$$mdtype":"Tag","name":"OpenApiResponseSample","attributes":{"descriptionFile":"oas-api-reference/index.yaml","operationId":"webhookApplicationSubscriptionCreate"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Creating a subscription automatically sends a test event to your callback URL so you can verify your endpoint is reachable."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"profile-level-webhooks","__idx":10},"children":["Profile-level webhooks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Profile-level webhooks send notifications when events occur for resources created under a specific Wise profile. ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["In most cases, Wise partners should subscribe at the application level rather than profile level."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you wish to subscribe to a webhook at the profile level, use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/webhook/webhookprofilesubscriptioncreate"},"children":["create profile webhook subscription endpoint"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -i -X POST \\\n  'https://api.wise.com/v3/profiles/{profileId}/subscriptions' \\\n  -H 'Authorization: Bearer <USER_TOKEN>' \\\n  -H 'Content-Type: application/json'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Instead of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLIENT_CREDENTIALS_TOKEN"]}," use a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USER_TOKEN"]}," for authorization. Instead of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clientKey"]}," in the endpoint path, use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["profileId"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request body and response are the same as application-level webhook subscriptions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only certain event types support profile-level subscriptions. Check the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/webhook-event"},"children":["webhook event list"]}," to see if your desired event is supported at the profile level."]}]},"headings":[{"value":"Subscribe to webhooks","id":"subscribe-to-webhooks","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Subscribe via Developer Hub","id":"subscribe-via-developer-hub","depth":2},{"value":"View active subscriptions","id":"view-active-subscriptions","depth":3},{"value":"Create a subscription","id":"create-a-subscription","depth":3},{"value":"View subscription detail","id":"view-subscription-detail","depth":3},{"value":"Delete a subscription","id":"delete-a-subscription","depth":3},{"value":"Subscribe via API","id":"subscribe-via-api","depth":2},{"value":"Request body","id":"request-body","depth":3},{"value":"Example request and response","id":"example-request-and-response","depth":3},{"value":"Profile-level webhooks","id":"profile-level-webhooks","depth":3}],"frontmatter":{"seo":{"description":"Subscribe to webhooks in Developer Hub or programmatically via the API.","keywords":["webhook management","subscriptions","events","delivery_attempts","retry event"],"title":"Subscribe to webhooks"}},"lastModified":"2026-06-18T10:42:03.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/developer/webhooks/subscribe-to-webhooks","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}