{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Frequently Asked Questions (FAQ)","description":"API documentation for Celonis APIs.","siteUrl":"https://developer.celonis.com/","keywords":"celonis developer portal, celonis apis, celonis api reference docs","lang":"en-US","llmstxt":{"hide":false,"description":"Celonis API documentation","sections":[{"title":"API Docs","description":"Available Celonis API Docs","includeFiles":["**/*.md"],"excludeFiles":[]},{"title":"API Specs","description":"All Celonis API specifications","includeFiles":["**/openapi.yaml"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"frequently-asked-questions-faq","__idx":0},"children":["Frequently Asked Questions (FAQ)"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requests-to-subscription-apis-are-blocked-by-the-browser-cors-policy-what-do-i-do","__idx":1},"children":["Requests to Subscription APIs are blocked by the browser CORS policy. What do I do?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When facing this issue, you will see a CORS error like the one below:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Access to XMLHttpRequest from origin 'http://localhost:4200' has been blocked by CORS policy: Response to preflight request doesn't pass access control check: No 'Access-Control-Allow-Origin' header is present on the requested resource.\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This error occurs when the browser is trying to make a request to a different origin (domain) than the one it's hosted"," ","on and the server the request is being sent to is not configured to allow cross-origin requests."," ","The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Access-Control-Allow-Origin"]}," header is used to specify which origins are allowed to access the resource. If this"," ","header is not present, the browser will block the request and the above error message will be displayed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Unfortunately, for security reasons, we can't add \"localhost\" to the response 'Access-Control-Allow-Origin' HTTP header,"," ","so this issue must be solved from the API consumer side."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In order to solve this problem, we recommend using a REST client instead of a web browser. This would also ease the"," ","process of setting the proper HTTP ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/process-intelligence-apis/subscription-api/get-started/getting-started#authentication"},"children":["Authorization"]}," headers as part of your requests."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"why-am-i-receiving-email-notifications-about-my-subscriptions","__idx":2},"children":["Why am I receiving email notifications about my subscriptions?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These email notifications are intended to keep you up to date with the latest activity related to  your subscriptions and triggers. Some of these notifications do require you to take action, such as restarting your subscription or reducing your total number of subscriptions, so it is recommended that you review these messages and take any necessary actions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information on these notifications and the actions required, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/process-intelligence-apis/subscription-api/notifications"},"children":["Email notifications for the Event Subscription API"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-can-i-recover-a-failed-subscription","__idx":3},"children":["How can I recover a failed subscription?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It can automatically recover when the destination webhook starts accepting Celonis messages. Alternatively, the consumer can recover the subscription by submitting new callback details (webhook URI or credentials). The failed messages are not lost; they are emitted after the communication is restored (unless the subscription has been configured to skip errors)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-can-i-recover-a-suspended-subscription","__idx":4},"children":["How can I recover a suspended subscription?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A suspended subscription can only be recovered by updating the subscription with new callback details. The failed messages are permanently lost."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-can-i-do-to-retrieve-messages-from-a-failing-subscription","__idx":5},"children":["What can I do to retrieve messages from a failing subscription?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are two ways:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Performing reconciliation and retrieving synchronously the failed messages (method ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH subscriptions/{subscription_id}/events"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Replaying the messages from the last successful offset (method ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH subscriptions/{subscription_id}/replay"]},")."]}]}]},"headings":[{"value":"Frequently Asked Questions (FAQ)","id":"frequently-asked-questions-faq","depth":1},{"value":"Requests to Subscription APIs are blocked by the browser CORS policy. What do I do?","id":"requests-to-subscription-apis-are-blocked-by-the-browser-cors-policy-what-do-i-do","depth":2},{"value":"Why am I receiving email notifications about my subscriptions?","id":"why-am-i-receiving-email-notifications-about-my-subscriptions","depth":2},{"value":"How can I recover a failed subscription?","id":"how-can-i-recover-a-failed-subscription","depth":2},{"value":"How can I recover a suspended subscription?","id":"how-can-i-recover-a-suspended-subscription","depth":2},{"value":"What can I do to retrieve messages from a failing subscription?","id":"what-can-i-do-to-retrieve-messages-from-a-failing-subscription","depth":2}],"frontmatter":{"seo":{"title":"Frequently Asked Questions (FAQ)"}},"lastModified":"2026-04-14T19:36:36.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/process-intelligence-apis/subscription-api/faq","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}