# Operate webhook endpoints

> PositiveForm guide · Developer setup · API-002
> Canonical page: https://positiveform.com/guides/developer/webhook-endpoints/
> This Markdown: https://positiveform.com/guides/developer/webhook-endpoints.md

**Summary:** Create, test, rotate, archive, and inspect customer webhook endpoints and deliveries. Endpoint state and delivery/replay history are visible without turning…  
**Who can do this:** Organization owners, Managers  
**Required access:** `integrations.manage`  
**Where in PositiveForm:** `/settings/developer/webhooks`  
**Status:** Verified on 2026-07-29 against PositiveForm build `beb3f3c`.

## Who this is for

This guide is for **integration staff** creating and inspecting customer webhook
endpoints and deliveries.

## Before you begin

- Have the destination URL your system will receive.
- Do not paste signing secrets anywhere outside PositiveForm.

## Steps

1. Open **Settings › Developer › Webhooks** (`/settings/developer/webhooks`).
   The heading is **Webhooks**.
2. Click **Create webhook** to add an endpoint.
3. Complete the URL, events, and secret fields the form requires, then save.
4. Return to the list to inspect delivery history, replay, archive, or rotate as
   offered on the endpoint.
5. Use **Developer** to return to API keys if needed.

## Expected outcome

Endpoint state and delivery/replay history are visible without turning the guide
into a full integration test harness.

## Screenshots

![Webhooks list with Create webhook](https://positiveform.com/guides/media/API-002/20260730T005000Z/000-start.webp)

## Recovery

If deliveries fail, open the endpoint detail for response codes before rotating
the secret. Archive unused endpoints rather than leaving dead URLs active.

## Related guides

- API-001

---

Source: PositiveForm customer guides, https://positiveform.com/guides/. 
Every guide as one file for AI assistants: https://positiveform.com/llms-full.txt. 
Guide index: https://positiveform.com/llms.txt.