Managing endpoints

An endpoint needs an https:// URL (or http://localhost / http://127.0.0.1 for development) and at least one event type.

Create

• Account-level: Dashboard → Profile → Webhooks → Add endpoint. Receives events from every event you own.
• Event-level: open the event, Settings → Webhooks → Add endpoint. Receives events from that event only.

Copy the signing secret from the endpoint card into your receiver. The card also shows the URL, subscribed event count, status, and consecutive failure count.

While an event has any active event-level endpoint, Pepvote sends that event's events only to its event-level endpoints, even if none of them subscribe to a given type. Disabled event-level endpoints do not override.

Edit, disable, enable

Edit changes the URL, description, or event types and keeps the secret. Disable stops deliveries without deleting anything. Enable resumes future deliveries and resets the failure count. It does not replay anything that was skipped or failed.

Roll the secret

Roll secret replaces the secret immediately. Have your receiver ready to update, because requests signed with the old secret stop verifying at once.

Delete

Delete removes the endpoint and stops deliveries. Nothing is replayed.

Limits

Two endpoints per account and two per event, counting disabled ones. Delete one to make room.

Related help

• Webhooks overview
• Delivery and retries
• Verifying signatures