Spoke’s integration with Action Kit allows you to directly upload your Action Kit reports into your text campaigns. The setup steps are to add an Action Kit user to the “Manage API Keys” section of the account settings page, then build or copy a text campaign. After selecting the Action Kit user in the Integrations section, go to the Contacts section and choose Action Kit, then type in the number of the report you want to upload. 

Step 1: Set up the Action Kit user in Settings

The first step to integrating Spoke and Action Kit is to share an Action Kit user’s credentials with Spoke. To do this, go to the Settings page of your Spoke team. Click the white “Manage API Keys” button in the top right corner. 

At the bottom right of the next page, you’ll see a green circle with a plus sign in the center – click this to access a popup where you can share the user credentials with Spoke.

In the popup, click on the Key Type field to access a dropdown menu, then select “Action Kit User”.

Next, add a nickname - this is the name that you’ll see when you select the Action Kit integration in your text campaigns. Fill out the remaining fields with user credentials for Action Kit: the user name, password, and Action Kit web domain (starting with the domain name, i.e. “roboticdogs”, and without https:// or anything before it).

Hit “Save” to add the integration to Spoke.

Step 2: Integrate a text campaign with Action Kit

To connect a campaign to Action Kit, create a new campaign or copy an existing campaign. Go to “Integrations” in your campaign and click on the field that says “No Integration” to open a dropdown menu. Select the Action Kit integration you want to use.

Hit “Save” to turn on the connection.

Step 3: Upload contacts from an Action Kit report

To upload your contacts from an Action Kit report, make sure your report contains columns for first names, last names, and phone numbers. Additionally, the phone number column must be renamed from "phone_numbers" to "cell".

Once your report is saved, head to “Contacts” in your Spoke text campaign. Click on the dropdown menu (the first option shown is “CSV Upload”), then select “Action Kit”.

Go to the Report ID field and type in the ID of the report you want to sync from Action Kit.

Hit “Save” to add the contacts from the report to the campaign.

Troubleshooting

‘ENOTFOUND https’ or ‘IP does not match certificate’s altnames’ errors

If you receive an error after adding a report ID in the “Contacts” section of your campaign such as:

•  “getaddinfo ENOTFOUND https”

• “Hostname/IP does not match certificate's altnames”

this means there is an issue with the domain name entered in the “Manage API Keys” section. Please go to Settings > Manage API Keys and click “edit” on the affected Action Kit integration, then remove any “https://” or “www.” in front of the domain name.

‘Action Kit API Error … 401’

If you receive an Action Kit API error, there is either an issue with the user credentials entered into the “Manage API Key” section, or the account you used doesn't have the necessary permissions in Action Kit. 

Please go to Settings > Manage API Keys and click “edit” on the affected Action Kit integration, and make sure the username and password are correct and placed in the correct fields. In addition, be sure to check that the account you used has "Super User" or "All Models" permissions in Action Kit (Super user status, or "all models").