GET
/webhooksList Webhooks
Retrieve all webhook endpoints for the authenticated account
Scope: WEBHOOKS_READ
Overview
Returns all webhook endpoints registered for the authenticated account, ordered by creation date (newest first). Secrets are masked — only the last 4 characters are shown.
Request
GET
/webhooksHeaders
| Header | Value |
|---|---|
Authorization | Bearer fxk_live_<your-api-key> |
Example Request
curl -X GET "https://api.formfex.com/api/v1/public/webhooks" \
-H "Authorization: Bearer $FORMFEX_API_KEY"Response
Response Fields
| Field | Type | Description |
|---|---|---|
data | WebhookEndpoint[] | Array of webhook endpoint objects |
data[].id | string | Unique webhook endpoint identifier (UUID) |
data[].url | string | HTTPS URL that receives webhook events |
data[].events | string[] | Array of subscribed event types |
data[].secretLast4 | string | Last 4 characters of the signing secret |
data[].isActive | boolean | Whether the endpoint is currently active |
data[].description | string | null | Optional description |
data[].createdAt | string | ISO 8601 creation timestamp |
data[].updatedAt | string | ISO 8601 last update timestamp |
Notes
Secret masking
The signing secret is always masked in API responses — only the last 4 characters are shown via secretLast4. The full secret is only available when the endpoint is first created through the Formfex dashboard.
Plan Requirement
Webhooks require a Starter plan or higher.