Integrations run after a submission is stored and emails are handled. Configure them on Notifal → Forms → Edit → Integrations.
Built-in adapters
| Integration | Requirements | Notes |
|---|---|---|
| Webhook | HTTPS URL | Server-side POST of sanitized fields. Only public HTTPS endpoints are accepted |
| Mailchimp | API key + audience/list settings | Server-side API call using Form CPT secrets |
Secrets such as webhook URLs and Mailchimp keys are stored on the Form CPT meta only. Never put them in template HTML attributes.
What gets sent
Adapters receive the sanitized field map for the submission. Do not expect raw browser request data or secret-bearing tokens.
Troubleshooting
| Symptom | Check |
|---|---|
| Webhook never fires | Integration enabled, HTTPS URL saved, Forms module enabled |
| Mailchimp fails | API key and list/audience settings on the Form CPT |
| Nothing is stored | Captcha, rate limiting, spam protections, or field validation may have blocked the submit |
Related articles
- Notifal Forms Overview
- Form Submissions and Settings
- Developers: Hooks: Forms (
notifal/forms/integration_adapters) - Cookbook: Extend Form Submit Lifecycle