AFI AFI

Sendy

Estimated reading: 3 minutes Updated August 1, 2026

Sendy is a self-hosted email newsletter application that uses Amazon SES for delivery. Advanced Form Integration subscribes contacts to your Sendy lists from WordPress form submissions.

What you’ll need

  • An active Sendy installation.
  • Your Sendy API Key and installation URL (see below).
  • The Advanced Form Integration plugin installed and activated.

Get your Sendy API credentials

  1. Sign in to your Sendy installation.
  2. Go to Settings and copy your API Key.
  3. Note your Sendy installation URL.
  4. In WordPress, go to AFI → Settings → Sendy.
  5. Click Add Account, enter the URL and API Key, and give the account a name.
  6. Click Save.

Create the integration

  1. Go to AFI → Add New.
  2. Give the integration a name, for example Form to Sendy.
  3. Under Trigger, pick the form plugin and the specific form.
  4. Under Action → Platform, select Sendy (free) or Sendy [PRO].
  5. In Task, choose the desired task.
  6. Pick the saved account and enter the List ID.
  7. Map your form fields onto the fields listed below.
  8. Optional: open Conditional Logic to limit which submissions are sent.
  9. Click Save Integration.

Screenshot: AFI field-mapping screen with Sendy fields visible

Tasks supported

Subscribe To List (Free + Pro)

Subscribes a contact to the selected Sendy list via form-encoded POST to the /subscribe endpoint.

Field Field key Required Notes
Email email Yes
Name name No

Pro features

The Pro integration extends the free version with custom fields, additional Sendy fields (country, GDPR, silent opt-in), and two extra tasks (Unsubscribe and Delete). Pro uses the same Sendy API Key and installation URL.

Custom fields and additional parameters

Pro exposes the following fields for the Subscribe task. Custom fields defined in your Sendy list can be mapped using the Custom Fields input, which accepts a key:value format.

Field Field key Required Notes
Email email Yes
Name name No
Country country No
IP Address ipaddress No
Referrer referrer No
GDPR gdpr No Set to true for GDPR-compliant opt-in of EU users
Silent silent No Set to true to bypass double opt-in and subscribe as single opt-in
Custom Fields custom_fields No Use key:value format. Example: Birthday:2000-12-12. For multiple fields, separate with commas: Birthday:2000-12-12,City:London. Do not use spaces. You can use form field placeholders as values.

Unsubscribe From List

Unsubscribes a contact from a Sendy list via the /unsubscribe endpoint. Only requires email and list ID.

Delete Subscriber

Deletes a subscriber entirely from a list via the /api/subscribers/delete.php endpoint. Only requires email and list ID.

Feature comparison

Feature Free Pro
Subscribe to list
Standard fields (email, name)
Custom fields No
Country, IP, Referrer No
GDPR consent flag No
Silent (bypass double opt-in) No
Unsubscribe from list No
Delete subscriber No

Conditional logic example

Only send data to Sendy when specific conditions are met. For example, add a condition on a form field to control which submissions are forwarded.

Troubleshooting

Nothing arrives in Sendy

Open AFI → Log and find the most recent entry. AFI stores the request URL, body, and raw response.

API credentials rejected

Verify your API Key and installation URL in AFI → Settings → Sendy. If the key was regenerated in Sendy, update it in AFI as well.

Related docs