> 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

Get a webhook call when a scan of an asset changes state, finishes or fails.

Telmai lets you set up 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

Webhooks are set per asset:

1. Open the asset from **Assets**.
2. On the **Overview** tab, find **Scan webhook** in the **Remediation & actions** card and click **Set up webhook** (or **Edit**).
3. In **Job notification webhook**, enter the **Webhook URL** where Telmai should send callbacks, for example `https://example.com/webhook`.
4. Click **Save**.

The **Scan webhook** row then shows the endpoint. See [Managing Assets](https://docs.telm.ai/telmai/connect-to-data/managing-assets.md#overview).

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