Google Sheets Integration

Importing contacts to Slack from Google Sheets.

Populating Your Google Sheet With Contacts

This article covers how to import contacts with a Google Spreadsheet Connector. We've made the connection seamless and secure for the users.
Navigate to clerk Dashboard by typing clerkand pressing Enter.
Click on the 📓 Contacts
Clerk Dashboard
Click on 📁 Import Contacts
Import Contacts
Under Google Sheets click on Import
Import Google Sheets
Authenticate with Google by selecting your account
Select Your Google Account
Allow secure access to a GSheet File
Confirm Access
Add Contacts
Clerk Contacts - Google Sheet


  • firstname: First Name
  • lastname: Last Name
  • phone: Phone Number
  • groups: cohorts of users (used in bulk sms)
    • Each contact can belong to multiple groups.
    • Just separate them with a comma. For example (NYC, SF).
Note: To make sure your contacts are synced back into Slack format the google sheet as indicated in the example below.
(456) 789-1011
sf, nyc
(212) 456-3456
Note: Do NOT change the names of the header columns
Phone Numbers: Format your phone numbers in any of the following ways:
  • (###) ###-####
  • +##########
  • ##########

Syncing Contacts

Clerk uses a pull mechanism to sync the contacts from your existing data source with Slack. Once connected and contacts have been added to your google sheet you need to explicitly:
🔄 Re-Sync Contacts
Re-Sync Contacts
Note: Depending on how large your contact list is the sync process can take a few minutes.
Once completed you will get a notification message on your Slack channel.
Contact Sync Complete

Open Google Sheet

You can access the created google sheet in two different ways.
Go to Google Drive and open Clerk Contacts google sheet.
Google Drive
Clerk Address Book
Clerk Address Book


If you are still having issues pulling your contacts from a google sheet there are a few things that you can try:
  • Force re-sync your contacts from the Address Book modal.
  • Make sure that First & Last Name are both populated. If they are missing in your Google sheet, Clerk will skip importing those contacts.
  • Due to the limitation of Slack search, we suggest limiting your group's character size to 10 characters.
  • Slack search is not ideal. When searching for a contact or a group do it one character at a time.
  • If you are still having issues please reach out to our support team at [email protected]