Wild Apricot integration
The Wild Apricot integration keeps your Gaggle Mail groups in step with your Wild Apricot membership, automatically. It reads your membership levels and member groups from Wild Apricot and keeps matching Gaggle Mail groups up to date, so members can start and reply to conversations straight from their inbox. The sync is one-way: Wild Apricot is in charge, and Gaggle Mail never changes anything in Wild Apricot.
This article covers what the integration does, how to set it up, how to remove people from a synced group, and how members choose what email they get. For an overview of features and benefits, see the Wild Apricot integration page.
What the integration does
- Adds and removes members for you. People who join a mapped membership level or member group in Wild Apricot are added to the matching Gaggle Mail group on the next sync. People who lapse or leave are removed. People you add to the group yourself are never removed by the sync.
- Keeps email addresses up to date. If a member's email address changes in Wild Apricot, it's updated in Gaggle Mail on the next sync, and their settings are kept.
- Runs daily, plus on demand. The sync runs once a day on its own. You can also click Sync now at any time, up to once every 10 minutes.
- Only reads from Wild Apricot. It connects with a read-only API key that you can revoke at any time.
- Honours unsubscribes. A member who unsubscribes stops getting email but stays in the group, and the sync never switches their email back on. See How members control their email.
- Checks big removals with you first. If one sync would remove an unusually large number of people from a group, Gaggle Mail holds those removals until you've reviewed them. See When a sync needs your review.
Before you start
The Wild Apricot integration is set up on an Organization and is available on any paid plan, including during a free trial. If you don't have an Organization yet, create one first — see Organization: Introduction. For a general overview of how integrations work, see Integrations.
How to set it up
Setup takes around five minutes. If you'd rather not do it alone, our support team is available 24/7 and happy to walk you through every step.
- In Gaggle Mail, open your Organization, click Integrations in the sidebar, find Wild Apricot and click Connect.
- Create an API key in Wild Apricot (see the steps below), paste it in and click Connect.
- Click Manage, then Add Mapping. Pick the Wild Apricot member group or membership level you want and click Sync this.
- Choose whether to sync it into a new group or an existing group, check the two options (see below), then click Create Mapping. Repeat for each level or member group you want to sync.
- Click Sync now to run the first sync straight away. If you don't, it runs with the next daily sync.
Getting your Wild Apricot API key
Gaggle Mail connects to Wild Apricot using a server application API key. To create one:
-
In Wild Apricot, go to Apps → Integration → Authorized applications.

-
Click Authorize application, choose Server application, then click Continue.

- Give the application a name (for example, "Gaggle Mail") and choose Read only access. Gaggle Mail only needs to read your members, never to change them.
- Copy the API key, then click Save.
- Paste the key into Gaggle Mail and click Connect.

The key is stored securely. You can revoke it in Wild Apricot at any time, which cuts off the integration's access straight away. If the key stops working, syncing pauses and the Integrations page shows Reconnect required: create a new key and reconnect with it.
How Wild Apricot maps to Gaggle Mail groups
You choose what syncs by setting up mappings. Each mapping feeds one Wild Apricot membership level or member group into one Gaggle Mail group. For example:
- Your "Active Members" membership level feeds your
members@group. - Your "Board" member group feeds your
board@group.
You can also map several levels or member groups into the same Gaggle Mail group — for example, all your membership levels into members@. Someone who is in more than one of them appears once, and is only removed when they're in none of them.
Each mapping has two options, set when you create it:
- Only sync current members (exclude lapsed memberships). On by default for membership levels, off by default for member groups. With it on, people are removed when their membership lapses. Members whose renewal is pending still count as current.
- Add existing members silently. On by default. The people already in the level or member group are added on the first sync without a welcome email. After that, new members get the group's welcome message, if it sends one.
Tip: a member group mapping includes lapsed members unless you tick "Only sync current members". If you want a group of current members only, map your membership levels with that option on.

Removing someone from a synced group
Wild Apricot decides who is in a synced group. To remove someone for good, make the change in Wild Apricot: end their membership, or take them out of the mapped level or member group. The next sync removes them from Gaggle Mail.
Don't remove synced members in Gaggle Mail. If they're still a current member in Wild Apricot, the next sync adds them straight back. Gaggle Mail warns you if you try: it explains this and offers Pause delivery instead, which stops their email and lasts. You can still choose Remove anyway. If you've selected several people, it tells you how many of them are synced, and can pause those and remove the rest.
Which to use:
- They should no longer be a member: change it in Wild Apricot.
- They should stay a member but stop getting email: pause their delivery in Gaggle Mail. They can switch it back on themselves from their membership page, so if they shouldn't be getting the group's email at all, change it in Wild Apricot.
- You added them to the group yourself (including anyone already in the group before you created the mapping): remove them in Gaggle Mail as normal. The sync doesn't manage them, so there's no warning and they won't come back. It also won't remove them for you if they lapse in Wild Apricot.
Every change shows in the Activity log with who or what made it — for example "added by Wild Apricot sync", "removed by Wild Apricot sync: membership lapsed" or "removed by you@example.com". Changes made by the sync carry a sync badge, so if someone you removed reappears, you can see why.
How members control their email
Being in a synced group doesn't mean getting every email. Each member chooses how they receive the group's messages on their membership page. The link is in the footer of every group message and in their welcome email.
- Every message: each message as it's sent. This is the default for new members.
- Daily digest: one email a day with that day's messages (when the group keeps a message archive). See Daily digest overview.
- Paused: no email for now. They stay a member and can switch back at any time.
Their choice is kept from one sync to the next. The sync never changes a member's delivery setting.
Unsubscribing. Members can also unsubscribe with the link in any message or the unsubscribe button their email app shows. In a synced group, unsubscribing stops all email from the group but keeps them a member, on every plan. (Removing them wouldn't last: the next sync would add them back.) The sync never switches their email back on, even if they're later removed and re-added. They can turn it back on themselves from their membership page. They can still send messages to the group and use the group website. For this reason, the group's Members can unsubscribe setting shows No and can't be changed while the sync is active. See Controlling member unsubscribes.
Leaving the group. Members can't leave a synced group themselves. If someone wants to leave altogether, they should ask you to end their membership, or take them out of the mapped level or member group, in Wild Apricot.
Changing their email address. Members should change their address in Wild Apricot. The next sync updates it in Gaggle Mail and keeps their settings. If they change it only in Gaggle Mail, the next sync changes it back.
When a sync needs your review
If one sync would remove more than 25 people and more than half of the people Wild Apricot manages in a group, Gaggle Mail holds those removals and asks you to check them first. It also holds them if Wild Apricot returns nobody at all for a group, which usually means a connection or setup problem rather than everyone leaving. Nothing is removed until you decide, and new members are still added in the meantime.
- Your Organization's administrators get one email with a link to the review. The Wild Apricot card on the Integrations page also shows a Review button.
- The review lists everyone who would be removed, which mapping they came from and why — for example "Lapsed" or "Not found in Wild Apricot (archived or deleted)".
- Everyone starts ticked. Untick anyone you want to keep, then click Remove selected, or click Keep everyone.
People you keep stay in the group as ordinary members, and the sync won't manage them any more. If the list is wrong because of something in Wild Apricot (a level renamed or deleted, members moved by mistake, the API key lost access), fix it there instead: the next sync works the list out again, and the hold clears on its own.
For the full walkthrough, see Wild Apricot "Needs review": check removals before they happen.
Good to know
- Your Wild Apricot data is never changed. The integration only reads from Wild Apricot.
- Sync history. Click Manage on the Wild Apricot card, then Sync history, to see each sync and how many people were added and removed.
- Removing a mapping or disconnecting. Syncing stops, and members already in the group stay but are no longer kept in sync. Disconnecting also deletes the stored API key.
- The key is revocable. Revoke the API key in Wild Apricot at any time to cut off access straight away.

