{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/process-intelligence-apis/subscription-api/notifications/","matchPath":"","result":{"data":{"markdownRemark":{"html":"<h1 style=\"position:relative;\"><a href=\"#email-notifications-for-the-event-subscription-api\" aria-label=\"email notifications for the event subscription api permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"email-notifications-for-the-event-subscription-api\"></div>Email notifications for the Event Subscription API</h1>\n<p>As part of using the Event Subscription API, you will receive email notifications sent by the service. Some of these notifications are for information purposes only, such as confirming that a new subscription has been created or informing you when a subscription has been paused. However, some of these notifications <strong>are crucial alerts</strong> such as your subscription has failed and others <strong>may require you to perform specific actions in order to keep your subscriptions active and functional</strong>. Depending on the type of notification, these actions may range from increasing your daily event limit to manually extracting unsent event data.</p>\n<p>Currently, the following event notifications may be received and should be reviewed for any potential actions required:</p>\n<ul>\n<li>\n<a href=\"#active-subscription\">Active Subscription</a>\n  \n</li>\n<li>\n<a href=\"#deleted-subscription\">Deleted Subscription</a>\n  \n</li>\n<li>\n<a href=\"#failed-subscription\">Failed Subscription</a>\n  \n</li>\n<li>\n<a href=\"#new-subscription\">New Subscription</a>\n  \n</li>\n<li>\n<a href=\"#paused-subscription\">Paused Subscription</a>\n  \n</li>\n<li>\n<a href=\"#resumed-subscription\">Resumed Subscription</a>\n  \n</li>\n<li>\n<a href=\"#rejected-subscription\">Rejected Subscription</a>\n  \n</li>\n<li>\n<a href=\"#suspended-subscription\">Suspended Subscription</a>\n  \n</li>\n<li>\n<a href=\"#too-many-subscriptions\">Too Many Subscriptions</a>\n</li>\n</ul>\n<p>See the sections below for more specific details on each notification.</p>\n<h2 style=\"position:relative;\"><a href=\"#active-subscription\" aria-label=\"active subscription permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"active-subscription\"></div>Active Subscription</h2>\n<p>Received to notify you that your subscription to a specific trigger is once again active and will begin forwarding new emitted events.</p>\n<p><strong>Triggering event:</strong></p>\n<ul>\n<li>\nPaused or suspended subscription is now active\n</li>\n</ul>\n<p><strong>Required actions:</strong></p>\n<ul>\n<li>\nNone\n</li>\n</ul>\n<p><strong>Optional actions:</strong></p>\n<ul>\n<li>\nManually extract untransferred events using the \n<a href=\"https://developer.celonis.com/process-intelligence-apis/subscription-api/api-reference/openapi/reference/operation/nextPageFromRemainingData/\">reconcile-url</a>\n</li>\n</ul>\n<h2 style=\"position:relative;\"><a href=\"#deleted-subscription\" aria-label=\"deleted subscription permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"deleted-subscription\"></div>Deleted Subscription</h2>\n<p>Sent to confirm that a subscription to a specific trigger has been deleted and will no longer be sending events.</p>\n<p><strong>Triggering event:</strong></p>\n<ul>\n<li>\nSubscription is deleted\n</li>\n</ul>\n<p><strong>Required actions:</strong></p>\n<ul>\n<li>\nNone\n</li>\n</ul>\n<p><strong>Optional actions:</strong></p>\n<ul>\n<li>\nNone\n</li>\n</ul>\n<h2 style=\"position:relative;\"><a href=\"#failed-subscription\" aria-label=\"failed subscription permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"failed-subscription\"></div>Failed Subscription</h2>\n<p>Notification that one of your current subscriptions has started to fail and cannot send your event data. Any events that are unable to be sent to you will be saved in the system, so no data will be lost.</p>\n<p><strong>Triggering event:</strong></p>\n<ul>\n<li>\nSubscription begins to fail\n</li>\n</ul>\n<p><strong>Required actions:</strong></p>\n<ul>\n<li>\nSubscription must be updated or deleted within 8 hours or it will be suspended.\n</li>\n</ul>\n<p><strong>Optional actions:</strong></p>\n<ul>\n<li>\nManually extract unsent events using the \n<a href=\"https://developer.celonis.com/process-intelligence-apis/subscription-api/api-reference/openapi/reference/operation/nextPageFromRemainingData/\">reconcile-url</a>\n</li>\n</ul>\n<h2 style=\"position:relative;\"><a href=\"#new-subscription\" aria-label=\"new subscription permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"new-subscription\"></div>New Subscription</h2>\n<p>Confirmation message that a new subscription was successfully created. These notifications also include basic information about the new subscription, such as the Subscription ID, Subscription Name, Protocol and Callback URL.</p>\n<p><strong>Triggering event:</strong></p>\n<ul>\n<li>\nNew subscription is created\n</li>\n</ul>\n<p><strong>Required actions:</strong></p>\n<ul>\n<li>\nNone\n</li>\n</ul>\n<p><strong>Optional actions:</strong></p>\n<ul>\n<li>\nNone\n</li>\n</ul>\n<h2 style=\"position:relative;\"><a href=\"#paused-subscription\" aria-label=\"paused subscription permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"paused-subscription\"></div>Paused Subscription</h2>\n<p>Notification that one of your active subscriptions has been paused and will not forward events to you until the subscription is resumed. Any events that are unable to be sent to you will be saved in the system, so no data will be lost.</p>\n<p><strong>Triggering event:</strong></p>\n<ul>\n<li>\nSubscription to a trigger has been paused\n</li>\n</ul>\n<p><strong>Required actions:</strong></p>\n<ul>\n<li>\nNone\n</li>\n</ul>\n<p><strong>Optional actions:</strong></p>\n<ul>\n<li>\nResume the subscription to begin receiving event data again\n</li>\n</ul>\n<h2 style=\"position:relative;\"><a href=\"#resumed-subscription\" aria-label=\"resumed subscription permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"resumed-subscription\"></div>Resumed Subscription</h2>\n<p>Indicates that a previously paused subscription has been resumed and will begin forwarding new events to you. Any unsent events that were saved while the subscription was paused will also be forwarded once the subscription is resumed.</p>\n<p><strong>Triggering event:</strong></p>\n<ul>\n<li>\nPaused subscriptions are resumed\n</li>\n</ul>\n<p><strong>Required actions:</strong></p>\n<ul>\n<li>\nNone \n-\n for informative purposes only\n</li>\n</ul>\n<p><strong>Optional actions:</strong></p>\n<ul>\n<li>\nNone\n</li>\n</ul>\n<h2 style=\"position:relative;\"><a href=\"#rejected-subscription\" aria-label=\"rejected subscription permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"rejected-subscription\"></div>Rejected Subscription</h2>\n<p>Notification that your subscription was rejected because the system has been unable to deliver events to your webhook. Any events that are unable to be sent to you will be saved in the system, so no data will be lost.</p>\n<p><strong>Received when:</strong></p>\n<ul>\n<li>\nSubscription unable to deliver events to webhook\n</li>\n</ul>\n<p><strong>Required actions:</strong></p>\n<ul>\n<li>\nCheck your webhook endpoint to ensure the webhook URL is correctly configured.  \n</li>\n<li>\nOnce fixed, manually update your subscription to reactivate.\n</li>\n</ul>\n<p><strong>Optional actions:</strong></p>\n<ul>\n<li>\nRetrieve unsent events using the following URL:  \n<p>PATCH /intelligence/api/subscriptions/${subscriptionId}/events</p>\n</li>\n</ul>\n<h2 style=\"position:relative;\"><a href=\"#suspended-subscription\" aria-label=\"suspended subscription permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"suspended-subscription\"></div>Suspended Subscription</h2>\n<p>Message sent when an active subscription has continuously failed and will be suspended. Includes the specific date on which the subscription began to fail. Any pending data will be lost as a result of the subscription being suspended.</p>\n<p><strong>Triggering event:</strong></p>\n<ul>\n<li>\nSubscription has continued to fail\n</li>\n</ul>\n<p><strong>Required actions:</strong></p>\n<ul>\n<li>\nSubscription must be updated or deleted to resume sending data.\n</li>\n</ul>\n<p><strong>Optional actions:</strong></p>\n<ul>\n<li>\nNone\n</li>\n</ul>\n<h2 style=\"position:relative;\"><a href=\"#too-many-subscriptions\" aria-label=\"too many subscriptions permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"too-many-subscriptions\"></div>Too Many Subscriptions</h2>\n<p>Warning message sent when you reach the maximum number of allowed subscriptions to knowledge model triggers. Reaching this limit will not impact any active subscriptions. However, it will prevent you from creating any new subscription.</p>\n<p><strong>Triggering event:</strong></p>\n<ul>\n<li>\nSubscription limit reached\n</li>\n</ul>\n<p><strong>Required actions:</strong></p>\n<ul>\n<li>\nNone\n</li>\n</ul>\n<p><strong>Optional actions:</strong></p>\n<ul>\n<li>\nDelete unneeded subscriptions  \n</li>\n<li>\nContact your account executive to increase your limit\n</li>\n</ul>","headings":[{"value":"Email notifications for the Event Subscription API","depth":1},{"value":"Active Subscription","depth":2},{"value":"Deleted Subscription","depth":2},{"value":"Failed Subscription","depth":2},{"value":"New Subscription","depth":2},{"value":"Paused Subscription","depth":2},{"value":"Resumed Subscription","depth":2},{"value":"Rejected Subscription","depth":2},{"value":"Suspended Subscription","depth":2},{"value":"Too Many Subscriptions","depth":2}]},"contentItem":{"data":{"lastModified":"2026-04-14T18:59:15.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"a607f421-46ad-5c99-8cff-e2ace6f20392__redocly content/process-intelligence-apis/subscription-api/notifications/","seo":{"title":"Email notifications for the Event Subscription API","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"process-intelligence-apis/subscription-api/notifications.md","pageBaseUrl":"/process-intelligence-apis/subscription-api/notifications","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Email notifications for the Event Subscription API","id":"email-notifications-for-the-event-subscription-api"},{"depth":2,"value":"Active Subscription","id":"active-subscription"},{"depth":2,"value":"Deleted Subscription","id":"deleted-subscription"},{"depth":2,"value":"Failed Subscription","id":"failed-subscription"},{"depth":2,"value":"New Subscription","id":"new-subscription"},{"depth":2,"value":"Paused Subscription","id":"paused-subscription"},{"depth":2,"value":"Resumed Subscription","id":"resumed-subscription"},{"depth":2,"value":"Rejected Subscription","id":"rejected-subscription"},{"depth":2,"value":"Suspended Subscription","id":"suspended-subscription"},{"depth":2,"value":"Too Many Subscriptions","id":"too-many-subscriptions"}]},"data":{"title":""},"catalogInfo":null,"link":"/process-intelligence-apis/subscription-api/notifications/","sidebarName":"celonis","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}