Subscription API Error Catalog

This section documents the errors that Subscription API may return (standard error messages are described in Common API Error Catalog).

Subscription to Triggers Endpoints Errors

Returned when Response
Status code Example
Unable to create the subscription to the EMS Trigger. 400 
{
   "title": "The subscription is not created",
   "status": 400,
   "detail": "We could not create the subscription, please retry. If the problem persists, please contact us.",
   "errorCode": "SUBSCRIPTION_TRIGGER_FAILED"
}
The uri provided in callbackInfo attribute, is not visible from Celonis 400 
{
   "title": "The provided callback is not reachable",
   "status": 400,
   "detail": "We checked the callback uri but it failed.",
   "errorCode": "SUBSCRIPTION_CALLBACK_FAILED"
}
You tried to create a subscription but the triggerId parameter is wrong. 404 
{
   "title": "Trigger not found",
   "status": 404,
   "detail": "The specified trigger id could not be located.",
   "errorCode": "SUBSCRIPTION_TRIGGER_NOTFOUND"
}
The uri provided in callbackInfo attribute, is not valid for the given protocol 400 
{
   "title": "The uri is not supported",
   "status": 400,
   "detail": "The requested URI does not support the required protocol.",
   "errorCode": "SUBSCRIPTION_URI_ILLEGAL"
}
The headers provided in callbackInfo are not valid 400 
{
   "title": "Empty header not allowed.",
   "status": 400,
   "detail": "Headers must contain a name and a value.",
   "errorCode": "SUBSCRIPTION_EMPTY_HEADER"
}
You tried to access to a subscription but the subscriptionId parameter is wrong. 404 
{
   "title": "Subscription not found",
   "status": 404,
   "detail": "The subscription does not exist.",
   "errorCode": "SUBSCRIPTION_SUBSCRIPTION_NOTFOUND"
}
You tried to manually extract data from a subscription, but the subscriptionId parameter has an illegal status (is Active or Paused). 400 
{
   "title": "Can't extract from subscription.",
   "status": 400,
   "detail": "This action cannot be performed because it is incompatible with the subscription's current status.",
   "errorCode": "SUBSCRIPTION_CANT_EXTRACT"
}
You tried to execute an action but the subscriptionId parameter has an illegal status (is Suspended). 400 
{
   "title": "Subscription is suspended",
   "status": 400,
   "detail": "This action cannot be performed because it is incompatible with the subscription's current status.",
   "errorCode": "SUBSCRIPTION_SUBSCRIPTION_SUSPENDED"
}
You tried to execute an action but the subscriptionId parameter has an illegal status for that action. 400 
{
   "title": "Illegal Subscription status",
   "status": 400,
   "detail": "This action cannot be performed because it is incompatible with the subscription's current status.",
   "errorCode": "SUBSCRIPTION_SUBSCRIPTION_ILLEGAL_STATUS"
}
You tried to access to a subscription but you don't have permissions. 403 
{
   "title": "Subscription access denied",
   "status": 403,
   "detail": "Subscription access denied.",
   "errorCode": "SUBSCRIPTION_SUBSCRIPTION_ACCESSDENIED"
}
You tried to create a new subscription but your quota is exceeded. 403 
{
   "title": "The subscription is not created",
   "status": 403,
   "detail": "Subscription limit reached. You have hit the maximum number of subscriptions allowed.",
   "errorCode": "SUBSCRIPTION_LIMIT_EXCEEDED"
}
You tried to create or update a subscription but your quantity of headers is exceeded. 400 
{
   "title": "Header limit exceeded",
   "status": 400,
   "detail": "The headers limit were exceeded.",
   "errorCode": "HEADER_LIMIT_EXCEEDED"
}
You tried to create or update a subscription but your size of headers is exceeded. 400 
{
   "title": "Header limit size exceeded",
   "status": 400,
   "detail": "The headers limit size were exceeded.",
   "errorCode": "HEADER_LIMIT_SIZE_EXCEEDED"
}
You tried to create or update a subscription but your headers contain non-allowed information. 400 
{
   "title": "Non Allowed Header Found",
   "status": 400,
   "detail": "The headers contain non-allowed information.",
   "errorCode": "NON_ALLOWED_HEADER_FOUND"
}
You tried to create or update a subscription but the name contains special chars that are not allowed. 400 
{
   "title": "Subscription attribute Name.",
   "status": 400,
   "detail": "Name value is not valid.",
   "errorCode": "SUBSCRIPTION_INVALID_NAME"
}
You tried to create a subscription but something went wrong in the process. 400 
{
   "title": "We couldn't subscribe.",
   "status": 400,
   "detail": "The subscription wasn't able to subscribe, please retry if the problem persist, please contact us.",
   "errorCode": "SUBSCRIPTION_UNABLE_CREATE"
}
You tried to delete a subscription but something went wrong in the process. 400 
{
   "title": "We couldn't unsubscribe",
   "status": 400,
   "detail": "The subscription wasn't able to delete, please retry if the problem persist, please contact us.",
   "errorCode": "SUBSCRIPTION_UNABLE_DELETE"
}
Not authorized. The operation is allowed only to the subscription owner or administators. 403 
{
    "title": "Not an allowed user",
    "status": 403,
    "detail": "Not allowed: only the subscription owner or team admins can perform this operation.",
    "errorCode": "SUBSCRIPTION_FORBIDDEN"
}
Not authorized. The operation is allowed only to the subscription owner or administrators. 403 
{
    "title": "Not an allowed user",
    "status": 403,
    "detail": "Not allowed: only the subscription owner or team admins can perform this operation.",
    "errorCode": "SUBSCRIPTION_FORBIDDEN"
}
Offset is Illegal. The replay operation could not be executed since the offset must be a value between 0 and the latest offset received for the subscription. 400 
{
    "title": "Offset is illegal",
    "status": 400,
    "detail": "The offset: XXX is not available",
    "errorCode": "SUBSCRIPTION_OFFSET_ILLEGAL"
}
Unexpected server-side error connecting to the Subscription. 500 
{
    “title”: “Unable to connect to the Subscription”,
    “status”: 500,
    “detail”: “We could not connect to the Subscription. Please retry, and if the error persist, please contact to Celonis.“,
    “errorCode”: “SUBSCRIPTION_FATAL_ERROR”
}
Requesting without a Mandatory parameter,paramName. 400 
{
   "title": "Missing mandatory parameters: param is mandatory.",
   "status": 400,
   "detail": "Missing mandatory parameters",
   "errorCode": "GENERAL_PARAMETER_MISSING"
}
Passing an empty paramName parameter. 400 
{
   "title": "Some params have constraint violations.",
   "status": 400,
   "detail": "[paramName: size must be between 1 and 200]",
   "errorCode": "GENERAL_CONSTRAINT_VIOLATION"
}
Passing an empty paramName parameter. 400 
{
   "title": "Value is not supported.",
   "status": 400,
   "detail": "Unsupported value for a field.",
   "errorCode": "GENERAL_CONSTRAINT_VIOLATION"
}
Sending special characters in the paramName parameter. 400 
{
   "title": "Special characters are not allowed.",
   "status": 400,
   "detail": "Some special characters were found and they are not allowed for querying.",
   "errorCode": "GENERAL_CHARS_NOTALLOWED"
}
Referencing a non-existing Knowledge Model. 404 
{
   "title": "Knowledge Model not found.",
   "status": 404,
   "detail": "The specified KnowledgeModel ID could not be located.",
   "errorCode": "KM_MODEL_NOTFOUND"
}
Requesting a non-existing field in the sort parameter. 400 
{
   "title": "Unknown sorting fields",
   "status": 400,
   "detail": "These fields don't exist at the given record [test].",
   "errorCode": "SORT_UNKNOWN_FIELD"
}
Sending an empty sort parameter. 400 
{
   "title": "Sort parameter error length.",
   "status": 400,
   "detail": "Sort parameter should not be empty.",
   "errorCode": "SORT_IS_EMPTY"
}
Sending, as part of the sort parameter, the same field with opposite sorting criterias. 400 
{
   "title": "Some sort fields have duplicated fields.",
   "status": 400,
   "detail": "Conflicting sort parameters: duplicate fields with opposite directions.",
   "errorCode": "SORT_HAS_OPPOSITE"
}