> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/integrations/jobs-status-notification.md).

# Jobs Status Notification

Telmai allows you to setup webhooks that get triggered when processing job status changes. If defined, the callback gets triggered when:

* Job is running
* Intermediate job state changes
* Job is completed

### Definition

The following params are sent as part of the body

<table><thead><tr><th width="202">Param</th><th>Description</th></tr></thead><tbody><tr><td><code>tenant</code></td><td>Associated tenant ID where the callback happened</td></tr><tr><td><code>source</code></td><td>Associated dataset source ID</td></tr><tr><td><code>jobId</code></td><td>Associated job ID</td></tr><tr><td><code>status</code></td><td>Job status (<code>IN_PROGRESS, FINISHED, FAILED, PREPARING, BATCH_WAIT</code>)</td></tr><tr><td><code>details</code></td><td>Description of job status</td></tr></tbody></table>

### Example Payload

When Telmai triggers a webhook, it sends a `POST` request to your URL with a JSON body similar to:

```json
{
  "tenant": "your-tenant-id",
  "source": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "jobId": "job-20260417-001",
  "status": "FINISHED",
  "details": "Job completed successfully"
}
```

### Usage

To use this feature, you will need to:

1. Navigate to the configuration page
2. Open the settings for the associated dataset
3. Click on **Job Notifications Settings**
4. In the **Webhook URL** field, enter the endpoint URL where Telmai should send callbacks
5. Click **Save** to apply the configuration

{% hint style="info" %}
Your webhook endpoint must be publicly accessible and respond with an HTTP `2xx` status code. Telmai retries delivery on failure.
{% endhint %}