Zapier Integration Setup
The following steps describes how to set up your Zapier integrations as well as formatting dates.
Prerequisites
Make sure you have a Zapier Account
Access to the SourceWhale Admin Panel
Step 1
In the SourceWhale app, go to Admin > Settings, and click ‘Generate API Key’, and copy the generated key.
Step 2
Then go to Dashboard in Zapier (https://zapier.com/app/dashboard), and navigate to ‘My Apps’ on the left panel.
Step 3
Click ‘Add connection’ and search for then click on SourceWhale.
Step 4
A window will appear prompting you to enter your generated API Key, then click ‘Yes, Continue to SourceWhale’.
SourceWhale will now have been connected to Zapier, and can be used to create Zaps.
You will be redirected to ‘My Apps’ > SourceWhale. In this page here you can see your SourceWhale connection(s), and any Zaps that you have created using SourceWhale.
Format Dates
SourceWhale sends dates in the unix time format to be able to send it to Zapier.
You'll need to transform this in Zapier. Follow the instructions on how to do that here
Using Zapier with SourceWhale
Zapier allows users to automate tasks, by creating ‘Zaps’. Zaps are made up of a trigger and one or more actions. A trigger is an event that occurs on a connected app (e.g. received an email, a spreadsheet being updated in Google Sheets, a contact being added to SourceWhale), which then automatically triggers an action on a connected app (e.g. send an email, update a spreadsheet, add a contact to SourceWhale).
How to create a Zap
Go to the Zapier Dashboard and click ‘Create Zap’ on the left panel.
Choose the trigger event.
Choose the action.
(Optionally) Create more actions by pressing the ‘+’ button between the steps of the Zap.
For SourceWhale, there are:
2 triggers:
Contact Added - Trigger - Triggers when a new contact is added.
Contact Updated - Trigger - Triggers when an existing contact is updated.
3 actions:
Find Contact - Action - Finds a contact with a specified email address, phone number, photo URL or social link.
Create Contact - Action - Creates a new contact.
Modify Contact - Action - Modifies an existing contact.
Creating a Contact Added / Contact Updated Trigger
When creating a Trigger, select SourceWhale, choose the Contact Added / Contact Updated event, and press Continue.
Choose your connected SourceWhale account, and press Continue.
Choose the Test Data Search Field and Value. These will be used to search SourceWhale for a contact to use as test data when creating and testing this Zap. Then press Continue. (N.B. Make sure the contact you search for does exist within SourceWhale! This contact will only be used when creating the Zap, and will be discarded once the Zap has been created.)
Press Test Trigger. Zapier will now search SourceWhale for our test contact, which will be used when creating subsequent actions as example data.
Creating a Find Candidate Action
When creating an Action, select SourceWhale, choose the Find Contact event, and press Continue.
Choose your connected SourceWhale account, and press Continue.
Choose the Search Field and Value. These will be used to search SourceWhale for a contact with those details. For example, choosing the Search Field as ‘Email Address’ and Search Value as ‘johnsmith@example.com’ will search SourceWhale for contacts who have that email address. The Search Field can be an Email Address, Phone Number, Image URL or Social Link. Then press Continue.
Press Test Action. This will search SourceWhale for a contact, using the test data that was given by previous Triggers/Actions.
Creating a Create Contact / Modify Contact Action:
When creating an Action, select SourceWhale, choose the Create Contact / Modify Contact event, and press Continue.
Choose your connected SourceWhale account, and press Continue.
(Modify Contact only) Enter the Contact ID of the existing SourceWhale Contact you wish to modify. If your previous steps do not provide a Contact ID, you can create a Find Contact Action before this action to search for a Contact in SourceWhale, and use the Contact ID received from that search.
Fill out the Contact details, and press Continue.
Press Test Action. This will Create / Modify a Contact in SourceWhale using the test data given from previous steps.
Example Zaps using SourceWhale:
When a contact is added to SourceWhale, that contact will be added to Google Contacts.
If you have contacts stored in a spreadsheet in Google Sheets, you could set up multiple zaps so that when contacts are created/modified in SourceWhale, the respective contact in Google Sheets is created/modified, and vice versa.
Stuck or need some help? Click on the chat icon at the bottom right-hand corner to connect with our support team! 💬