Search API Connector Documentation
Import ActiveCampaign Data to Google Sheets
In this guide, we’ll walk through how to pull data from the ActiveCampaign API directly into Google Sheets, using the API Connector add-on for Sheets.
We'll first get an API key from ActiveCampaign, and then set up a request to pull in contact data from ActiveCampaign to your spreadsheet.
Contents
- Before You Begin
- Part 1: Get ActiveCampaign API Key
- Part 2: Pull ActiveCampaign API Data into Sheets
- Part 3: Handle Pagination
- Part 4: API Documentation
Before You Begin
Click here to install the API Connector add-on from the Google Marketplace.
Part 1: Get Your ActiveCampaign API Key
- Log in to ActiveCampaign and click Settings in the left side navigation menu.
- The Account Settings menu will appear. Click Developer.
- You should now see a page containing your API URL and Key. Keep the key handy as you'll need it in a moment. Congrats! You're now ready to use the ActiveCampaign API.
Part 2: Pull ActiveCampaign API Data into Sheets
For this example, we'll get a list of contacts created before a certain date. Where it says your-domain
, substitute in your own domain (you should be able to see this in the URL bar when you're logged into ActiveCampaign).
- Open up Google Sheets and click Extensions > API Connector > Open > Create request.
- In the request form enter the following:
- Application:
Custom
- Method:
GET
- Request URL:
https://your-domain.api-us1.com/api/3/contacts&limit=100&filters[created_before]=2020-03-08
- Headers:
API-Token
:your_api_key
- Application:
- Create a new tab and click Set current to use that tab as your data destination.
- Name your request and click Run. A moment later you’ll see a list of contacts populate your sheet.
Notes
- Change the endpoints as described in the documentation to retrieve different data. For example, changing it from
/contacts
to/campaigns
will produce a list of all your ActiveCampaign campaigns. - If your contacts utilize custom fields, these custom field values can be retrieved using the
/fieldValues
endpoint. As the fieldValues endpoint will only produce their ID, you can also use the/fields
endpoint to get their name. Once you have all the values in Sheets, you can merge them together as desired using queries and other functions native to Sheets.
Part 3: Handle Pagination
- Note Active Campaign's limits on the number of records returned on a response. By default, only 20 records will be returned unless you use the 'limit' and 'offset' parameters as described in their documentation.
- With API Connector you can either add those parameters manually or loop through them automatically with offset-limit pagination handling (paid feature), like this:
- API URL: enter your request URL as usual, including limit=100
- Pagination type:
offset-limit
- Offset parameter:
offset
- Limit parameter:
limit
- Limit value:
100
- Run until: choose when the request should stop running.
Part 4: API Documentation
Official API documentation: https://developers.activecampaign.com/reference