Receive notifications by webhook
The notifications Elion ITSM sends to your system when the team replies, changes the status, resolves or closes a case, and how to process them.
If the channel has an outbound URL, Elion ITSM notifies your system of what happens with each case created by that channel. That way your application shows the reply to the user and notifies them, without polling all the time.
Before you start
The outbound URL is set up on the channel: read Case channels. It is a field of each channel; you can change it whenever you want.
Your system must verify each notification's signature with the outbound secret. Read Sign requests.
The notifications
Each notification is a POST with this body:
{
"type": "case.reply",
"timestamp": "2026-10-13T14:20:46.120Z",
"data": {
"case": { "number": "INC-000123", "externalId": "7c1e0b9a-…", "stateLabel": "En revisión", "publicMessages": [] },
"message": { "id": "981", "side": "agent", "author": "Carla Soto", "body": "Hola Ana, ¿qué formato elegiste?", "at": "2026-10-13T14:20:45.000Z", "attachments": [] }
}
}data.case contains the full case, just like the API (read Create and track cases through the API). Look it up in your system by externalId.
| When it arrives | What to do |
|---|---|---|
| The team wrote a reply to the requester. It includes | Show the reply and notify the user. |
| The status changed. | Update the status you show. |
| The case was resolved. | Let them know it is resolved. |
| It arrives along with the resolution if there is a pending survey. | Show the 1 to 5 survey. |
| The case was closed. | Mark it as closed. |
| Someone clicked Test outbound on the channel. | Just answer 200. |
The team's internal notes are never sent.
How to respond
Answer 2xx as soon as you record the notification. If something takes time, do it afterwards.
If you answer another code or do not answer within 15 seconds, Elion ITSM retries after 30 seconds, 2 minutes, 10 minutes, 1 hour, 6 hours and 12 hours, for 24 hours at most. After that it marks it failed.
The
webhook-idis the same in every retry of a notification. If you already processed it, answer 200 without repeating what you did.
Review deliveries
In the desk's Settings → Case channels, click View deliveries on the channel. You see the last 50 notifications with their event, case, status, attempts, HTTP code and error. The channel list also shows the Last sent and the last error.