---
title: "Update Audit Report webhook settings"
method: POST
path: "/sexoffender/report/live/webhook"
---

# Update Audit Report webhook settings

`POST /sexoffender/report/live/webhook`

## Request

- Base URL: `https://api.offenders.io`
- URL: `https://api.offenders.io/sexoffender/report/live/webhook`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Manage this account’s Audit Report notification settings. Requires eligible API key. Send one credential header and no query parameters. Send url, active and the current revision. A successful save increments revision; refresh after 409. HTTPS only; no credentials, fragments or redirects. Pending deliveries and retries use your latest saved endpoint.

## Request body

- ReportWebhookSettingsUpdate
  - `url` string, nullable, required: Public HTTPS callback URL on port 443, without credentials or a fragment. Set null with active false to clear the endpoint.
  - `active` boolean, required
  - `revision` integer, required: Use 0 for the first save. For later changes, use the latest revision returned by a successful save or GET. After 409 settings_changed, read the current settings before saving again.

## Response `200`

Current account setting and optional signature verification key.

- ReportWebhookSettings
  - `url` string, nullable, required: Configured callback URL; null before a URL has been saved.
  - `active` boolean, required
  - `revision` integer, required
  - `public_key_pem` string, nullable, required: Public key for optional Webhook signature verification for your account.
  - `signature_header` 'X-Offenders-Webhook-Signature', required

## Other responses

- `400`: Invalid settings or callback URL. Use a public HTTPS URL on port 443 without credentials or a fragment.
- `401`: Missing, invalid or inactive API credential.
- `403`: The credential cannot manage this account setting or lacks current workflow access.
- `405`: Unsupported method. Use GET to read settings or POST to save them.
- `409`: Settings changed. Fetch the current revision before saving again.
- `413`: The JSON settings request exceeds 4096 bytes.
- `503`: Callback settings are temporarily unavailable.

## Changes

- **2026-10-26** `37610ebaea73`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/offenders/apis/offenders-io-sex-offender-registry-api/changes/sexoffender/report/live/webhook/post.md)

---

[API](https://skmtc.dev/offenders/apis/offenders-io-sex-offender-registry-api.md) - [All operations](https://skmtc.dev/offenders/apis/offenders-io-sex-offender-registry-api/llms.txt) - [OpenAPI document](https://skmtc.dev/offenders/apis/offenders-io-sex-offender-registry-api/revisions/84be421d2ba6?raw)
