This document is about how to change webhook settings using the API. Webhooks settings can also be directly modified by users through the user interface by accessing the Moaform service. For instructions on changing webhook settings directly within the Moaform service, please refer to Webhook > Webhook Management.
You can change the settings of a specific webhook (webhook_id) for a specific form (form_id).
[PUT or PATCH] https://api.moaform.com/forms/{form_id}/webhooks/{webhook_id}
REQUEST
Path Parameters
| Key | Description |
|---|---|
| form_id | Required. Unique ID of the form |
| webhook_id | Required. Unique ID of the webhook |
Body
| PARAMETER | TYPE | DESCRIPTION |
|---|---|---|
| endpoint | string | Required. Webhook receiver URL |
| enabled | boolean | Webhook activation status |
| secret | string | Secret code |
| verify_ssl | boolean | Endpoint SSL certificate verification status |
| retention_days | integer | Resend restriction days (choose from 1, 3, 5, 7, 10, 15, 30) |
When changing settings, all values are optional. If not entered, the existing settings will be used as is.
RESPONSE
| Key | Type | Description |
|---|---|---|
| id | string | Unique ID of the webhook |
| endpoint | string | Endpoint of the webhook |
| enabled | boolean | Activation status of the webhook |
| secret | string | Secret code |
| verify_ssl | boolean | Endpoint SSL certificate verification status |
| retention_days | integer | Days limit for resending |
| created_at | string | Webhook creation timestamp |
| updated_at | string | Webhook modification timestamp |