Skip to main content

Newsletter sync (Mailchimp, ConvertKit)

Confirmed alert subscribers flow into your own list automatically.

Written by Traian

If you run a newsletter alongside your job board, you can connect your own Mailchimp or ConvertKit account, and every job-alert subscriber who confirms their email is automatically added to your list as well. You bring your own API key; easyboard stores it encrypted at rest and only ever uses it server-side.

How the sync works

  • The trigger is the double opt-in confirmation: the moment a subscriber clicks Confirm alerts in their job-alert email, easyboard adds their address to your connected list. This means everyone who lands in your newsletter has actively confirmed their email, which most newsletter providers require anyway.

  • Only new confirmations sync. Connecting the integration does not backfill people who confirmed before you connected; export those from Engagement, Subscribers with Export CSV and import them into your provider once.

  • The sync is best-effort by design: if your provider is briefly unreachable, the alert subscription itself still succeeds. Job alerts never break because of a newsletter hiccup.

  • Newsletter sync is available on the Advanced and Enterprise plans. On the Pro plan the card is replaced by an upgrade prompt; see Your easyboard subscription.

Get your Mailchimp credentials

You need two values from Mailchimp:

  1. API key: in Mailchimp, open your profile, then Extras, then API keys, and create one. Mailchimp keys end in a datacenter suffix, for example abc123-us21. That suffix is required; easyboard reads it to know which Mailchimp server to talk to, and a key without it is rejected as invalid.

  2. Audience ID (also called list ID): in Mailchimp, open your audience, then Settings, then "Audience name and defaults"; the Audience ID is listed there as a short code like a1b2c3d4e5.

Subscribers are added with the status "subscribed". If an address already exists in your audience, it is updated rather than duplicated, so you will not get "already a member" errors.

Get your ConvertKit credentials

Also two values:

  1. API key: in ConvertKit (now called Kit), open Settings, then Advanced; your API key is listed there.

  2. Form ID: easyboard subscribes people to a specific ConvertKit form. Open the form in ConvertKit and take the numeric ID from its URL. Anyone added through the form enters that form's confirmation flow, exactly as if they had filled it in themselves.

Connect it in the dashboard

  1. In the sidebar, open Engagement and click Email & newsletter.

  2. Scroll to the Newsletter card.

  3. Pick your Provider: Mailchimp or ConvertKit.

  4. Fill in the ID field. Its label follows the provider: Audience (list) ID for Mailchimp, Form ID for ConvertKit. This field is required.

  5. Paste your key into API key (for Mailchimp the label reminds you of the format: "API key (e.g. abc123-us21)"). The field is masked like a password.

  6. Leave the Active switch on ("Add new confirmed subscribers to the list"). You can toggle it off later to pause syncing without losing the connection.

  7. Click Connect. The button stays disabled until you have entered an API key.

On success you see a "Newsletter connected" toast, the API key field clears (the key is now stored server-side), and two new buttons appear: Send test and Disconnect. The main button now reads Update.

The Newsletter card on the Email and newsletter page with Provider, Audience (list) ID, API key, and the Active switch

Test the connection

  1. Click Send test.

  2. Enter an email address you control in the prompt (your own is fine).

  3. easyboard performs a real subscribe against your provider with the stored credentials.

Success shows a "Subscribed the test address" toast, and the address appears in your Mailchimp audience or ConvertKit form within moments. A failure shows the provider's actual error message, for example "Mailchimp 401" for a bad key or "Mailchimp 404" for a wrong audience ID, which tells you exactly which value to fix.

Update, pause, or disconnect

  • Change the list or provider: edit the fields and click Update. Leaving API key blank keeps your existing stored key, so you only re-enter it when it actually changed.

  • Pause: switch Active off and click Update. The connection and key are kept, but new confirmations stop flowing.

  • Disconnect: click Disconnect to delete the stored credentials entirely. People already added to your provider are not removed.

Tip: if your plan is downgraded below Advanced, syncing stops but your connection is kept, so upgrading again resumes it without re-entering keys.

Related

The emails easyboard itself sends to these subscribers are styled under Email branding. The full signup and confirmation flow is covered in Job alerts.

Did this answer your question?