> ## Documentation Index
> Fetch the complete documentation index at: https://docs.harbinge.rs/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook Settings

> Configure Forager to push attestations to ServiceNow or any CMDB

Webhooks let Forager automatically notify an external system every time an attestation is recorded. The most common use is pushing location updates to ServiceNow CI records.

Prefer a no-code path? The [Zapier integration](/integrations/zapier) needs no endpoint or payload template — you generate an [API key](/dashboard/api-keys) and build Zaps directly in Zapier.

## Where to find it

Webhook configuration is in the **Forager Android app**, not the web dashboard. You must be logged in as an admin.

From the home screen: tap your profile avatar → **Admin** → expand the **Webhooks** section.

## Where to configure

Webhooks can be configured from two places:

* **Web dashboard** (recommended): Dashboard → Settings → Webhooks
* **Android app**: Profile → Admin → Webhooks section

The web dashboard offers the full configuration experience including platform selection and payload preview.

## Adding a webhook

<Steps>
  <Step title="Open Webhook Settings">
    In the web dashboard, go to **Settings** and scroll to the **Webhooks** section. Click **Add Webhook**.
  </Step>

  <Step title="Enter the endpoint details">
    | Field            | What to enter                                                  |
    | ---------------- | -------------------------------------------------------------- |
    | **Name**         | A label for your own reference, e.g. `Freshservice Production` |
    | **Endpoint URL** | The full HTTPS URL Forager will POST to on every attestation   |
    | **Auth Header**  | The HTTP header used for authentication, e.g. `Authorization`  |
    | **Auth Value**   | The credential value, e.g. `Bearer token...`                   |
  </Step>

  <Step title="Select a target platform">
    Choose your ITSM/CMDB from the **Target Platform** dropdown. Forager will pre-format the payload for that platform — no custom template needed. A payload preview appears so you can see exactly what your endpoint will receive.

    Select **Custom template** to write your own JSON payload using the available template variables.
  </Step>

  <Step title="Save">
    Click **Add Webhook**. The webhook is active immediately.
  </Step>
</Steps>

## Supported platforms

| Platform          | Pre-built payload | Field mapping guide                                             |
| ----------------- | ----------------- | --------------------------------------------------------------- |
| Freshservice      | Yes               | [Freshservice](/integrations/freshservice)                      |
| JSM Assets (Jira) | Yes               | [JSM Assets](/integrations/jira-assets)                         |
| BMC Helix ITSM    | Yes               | [BMC Helix](/integrations/bmchelix)                             |
| Ivanti Neurons    | Yes               | [Ivanti](/integrations/ivanti)                                  |
| ServiceNow        | Custom template   | [Scripted REST API](/integrations/servicenow-scripted-rest-api) |
| Any other system  | Custom template   | [Webhook Reference](/integrations/webhook-reference)            |

## Custom template variables

When using a custom template, these variables are available:

| Variable            | Description                                                         |
| ------------------- | ------------------------------------------------------------------- |
| `{{asset_tag}}`     | The scanned asset tag                                               |
| `{{location_path}}` | Full breadcrumb, e.g. `Building A / Floor 2 / IT Office`            |
| `{{anchor_name}}`   | Room name only, e.g. `IT Office`                                    |
| `{{updated_by}}`    | Display name of the tech who scanned                                |
| `{{type}}`          | `match`, `mismatch_confirmed`, `mismatch_dismissed`, or `new_asset` |
| `{{timestamp}}`     | ISO 8601 UTC timestamp                                              |

## Disabling a webhook temporarily

Toggle the switch on the webhook card to off. Attestations continue to be recorded in Forager — they are not queued for later delivery. Re-enable when ready; only new attestations from that point forward will be sent.

## Detailed setup guides

<CardGroup cols={3}>
  <Card title="Webhook Reference" icon="book" href="/integrations/webhook-reference">
    Full payload schema, field definitions, and OpenAPI spec download
  </Card>

  <Card title="ServiceNow — Scripted REST API" icon="code" href="/integrations/servicenow-scripted-rest-api">
    Recommended for direct, real-time CI updates
  </Card>

  <Card title="ServiceNow — Import Sets" icon="table" href="/integrations/servicenow-import-sets">
    For environments that require staged CMDB writes
  </Card>
</CardGroup>