Managing endpoints

Account-level endpoints

Account-level endpoints receive events for every voting event you own. Manage them from Profile → Webhooks in your dashboard.

Creating an endpoint

1. Go to Profile → Webhooks.
2. Click Add endpoint.
3. Enter your endpoint URL (must be HTTPS in production).
4. Add an optional description to identify the endpoint.
5. Select the event types you want to receive.
6. Click Create endpoint.

After creation, your signing secret is visible on the endpoint card. Copy it and store it securely in your server configuration.

Editing an endpoint

Click Edit on any endpoint card to update the URL, description, or subscribed event types.

Rolling the secret

Click Roll secret to generate a new signing secret. The previous secret is replaced immediately, so update your server configuration before rolling.

Disabling and enabling

Click Disable to stop deliveries without deleting the endpoint. Click Enable to resume. Re-enabling resets the failure counter.

Deleting an endpoint

Click Delete and confirm in the dialog. This permanently removes the endpoint and stops all deliveries. Pending retries for this endpoint are abandoned.

Event-level endpoints

Event-level endpoints override account-level endpoints for a specific voting event. When a voting event has its own endpoints, only those fire for that event's activity. Account-level endpoints are skipped.

Creating an event-level endpoint

1. Open the voting event in your dashboard.
2. Go to Settings → Webhooks.
3. Click Add endpoint and follow the same steps as account-level.

If no event-level endpoints exist for a voting event, account-level endpoints apply.

Limits