What this integration does
Syncs donors daily — opted-in donors with a mobile phone number are automatically added to your Tatango list every day
Syncs opt-outs in real time — when a donor texts STOP, their opt-out status is updated in DonorPerfect within seconds
Syncs gifts hourly — new donation records are pushed to Tatango every hour so you can see which SMS messages are driving donations
Before you get started
Make sure you have the following ready before beginning setup:
In DonorPerfect:
Your DonorPerfecr API key
In Tatango:
A Tatango list to sync donors into
A custom field to store the DonorPerfect donor ID (e.g. named
Donor ID) — you must create this before starting setup
Step 1 — Open the Integration Setup
In Tatango, click on My Account in the top navigation
Go to Integrations
Find DonorPerfect in the list and click Configure
Step 2 — Connect DonorPerfect
When prompted, paste the API key you generated in Step 1
Click Connect — the integration will verify that the key works
If you see an error, double-check your API key
Step 3 — Select Your Tatango List
Select the Tatango list you want your donors synced into.
Step 6 — Map Your Fields
This step lets you choose which DonorPerfect fields should sync to which Tatango fields.
The left column shows DonorPerfect fields. The right column shows Tatango fields. Use the dropdowns to match them up.
A few things to keep in mind:
Your mobile phone number is handled automatically, you don't need to map them here
Whatever data you map here is what we bring over to Tatango from DonorPerfect as part of this integration.
Step 7 — Select Your Donor ID Field
Choose which Tatango custom field stores the DonorPerfect Donor ID.
This is the field you created in Step 2. It's used by the integration to match Tatango subscribers back to DonorPerfect records when someone opts out.
Step 8 — Connect Tatango Opt-Outs
On the last page, a webhook URL will appear below. To complete the opt-out sync:
In Tatango, go to Lists and select your list
Go to Settings → Webhooks
Click Create New Webhook
Paste the webhook URL from below
Check the Unsubscribes box
Click Save
This ensures that whenever a subscriber texts STOP, their opt-out status is automatically updated in DonorPerfect in real time.
What happens after setup
Once the integration is enabled:
The first run stores today's date and exits — no contacts are synced on the first run. This is expected. From the next day onwards, donors who are created or modified in DonorPerfect will start syncing into Tatango automatically.
Opt-outs start syncing immediately — as soon as the integration is enabled, any donor who texts STOP will have their opt-out reflected in DonorPerfect.
Gift records sync every hour — new donations made in DonorPerfect will appear as donation records on the matching Tatango subscriber.