Zapier Integration Guide

Last updated Oct 8th, 2024

Overview

This guide will walk through our integration with Zapier along with example workflows that demonstrate how to integrate Common Room with other apps and services. The Zapier integration is available on all plans.

Zapier is a platform that makes it easy to build automated workflows customized for your role and business. Our Zapier integration allows you to extend the powerful integrations and data in Common Room into other tools that may be in your tech stack. And, you'll be able to get the most data into Common Room from any Zapier supported app, providing you with the most complete view of your community and its Contacts.

Introduction to Zaps

A Zap is an automated workflow where triggers result in specific actions. For example, you could create a Zap that triggers when a new lead is identified in Facebook and an action that adds that lead directly to Common Room.

Here are some more examples that show just a few of the many ways you can integrate Common Room with other applications through Zapier.

Example Zapier templates for Common Room

Below is a list of the available actions you can create in Zapier.

ActionDescription
Add Contact from Third Party Signal
Allows you to add a Contact along with their information into Common Room. If the Contact already exists in Common Room, we will merge the new information into the existing Contact. Requires a destinationSourceId which is provided when you set up an API signal .
Add Activity from Third Party Signal
Allows you to add activities to a Contact. This Activity will show in the Contact's timeline and is searchable via the input “Signal”. Check out the Appendix for a list of accepted Activity types.Requires a destinationSourceId which is provided when you set up an API signal .
Add Note to Contact
Allows you to add notes to a Contact which will show in the team bar.
Add Tags to Contact
Allows you to add tags to a Contact.
Update a Contact Custom Field
Allows you to update the value of an existing Contact custom field. Custom fields are searchable and their values are viewable on Contact profile pages.
Add Contact to Segment
Allows you to add a Contact to a segment along with a status as well as update the status of a Contact in a segment.
Add Note to Segment
Allows you to add notes to segments which will show in the team bar.
Get a Contact
Allows you to get information on a Contact given a Contact social to search. Output information includes: name, Activity count, avatar, Organization, organization domain, title, first seen date, last active data, location, Contact tags, any segments the Contact is in, and any social information.


Prerequisites

Before you start creating Zaps, make sure you have an API token. Check if the trigger you plan to use outputs the required Contact information i.e. an email, Twitter, GitHub, or LinkedIn handle. If you’ve never used Zapier before, take a look through their key concepts.


Example Workflow: Importing Contact Activity

In this example, let’s say that you have been maintaining a Google Sheet with Contacts and Activity information. Every time you have a new Contact or Contact Activity, you add a new row to your spreadsheet, leaving you with a repository of both historical data and new data being added on a regular basis.

You can import both sets of information into Common Room to leverage our advanced features by following the steps below.

Create a Zapier Trigger

  1. Click Create Zap from the Zapier home screen.
  2. Select Google Sheets as the trigger.
  3. Select New or Updated Spreadsheet Row as the trigger event.
  4. Choose the Google Account, spreadsheet, and worksheet where you store your Contact Activity.
  5. Test your Zap to ensure everything is configured correctly.

Create a Zapier Action

  1. Click Action and select Common Room from the list of options.
  2. Choose Add Activity from Third Party Signal as the action event.
  3. Choose your Common Room account.
  4. Enter the required fields that are listed below, as well as any optional fields you'd like to include.
  5. Test your Zap before publishing to begin syncing data with Common Room.
Required FieldDescription
Common Room Destination ID
A required field that represents the API Signal that was created in the previous step.
Activity Type
A required field that represents the specific type of the Activity. The full list of supported Activity types can be found in the appendix below.
Activity ID
A required field that represents any id that uniquely identifies this Activity. You can select any identifier you wish that is provided from the source. In the case of Google Sheets, one potential id would be the row id.
Used ID
A required field that represents any id that uniquely identifies the Contact associated with this Activity. You can select any identifier you wish (e.g. guid, email, social handle) as long as it can consistently be used to reference the Contact from this third party source.

Transfer Existing Data

Once Zapier returns a success response from the test, you should now be able to go to Common Room and see the new Activity and Contact. After you click publish, you will be prompted to run your Zap on the existing contents of your file with "Transfer existing data". This is a great way to transfer data you’ve already collected.

FAQ

How do I troubleshoot Zapier errors?

Always check the error in your Zap before making changes to your Zap. If you change a Zap, you may not be able to replay it. So it’s always best to check out what’s causing an error before modifying anything. To do this, go to “Zap History” in your Zapier account. This is typically in the left navigation bar. Look at your “Zap runs” and filter to runs with “Errored” status.

Click into the error run and take a look at the error text. If it’s unclear what the problem is, take a screenshot of the error and post it in the Uncommon Slack Community or send to support.

If a step fails in a multistep zap, subsequent steps can still succeed. It’s possible that you have gotten an error that you can ignore. Please contact support. We are happy to help.

Is it possible to import massive datasets into Common Room through Zapier?

We at Common Room have tried to import massive datasets through Zapier into Common Room. We’ve found that this is a costly experience through Zapier. Please contact support and verify that this is the right solution for you.

What Common Room Activity types are accessible through Zapier?

  • Accepted a meeting
  • Activity on a feature request or idea
  • Answered a call
  • Answered a form or survey
  • Applied to champion or ambassador program
  • Attended a demo
  • Attended a meeting
  • Attended a product discovery call
  • Attended a product roadmap call
  • Attended a webinar
  • Attended an event
  • Booked a meeting
  • Called in
  • Commented on ticket or issue
  • Commented or replied
  • Completed onboarding
  • Completed training
  • Completed transaction
  • Created a ticket or issue
  • Created an account
  • Created training material
  • Deal closed
  • Deal created
  • Declined a reward
  • Eligible for a reward
  • Enrolled in champion program
  • Enrolled in training
  • Graduated from champion or ambassador program
  • Hosted a meeting
  • Hosted a webinar
  • Hosted at event
  • Identified as a power user
  • Joined a group or forum
  • Joined advisory board
  • Liked or reacted
  • Link
  • Logged in
  • Made a commit
  • Made a merge request
  • Made a post or topic
  • Made a referral
  • Ordered sticker(s)
  • Ordered swag
  • Other
  • Participated in an early access program
  • Presented at a webinar
  • Presented at event
  • Provided case study or quote
  • Provided product feedback
  • Received a call but did not answer
  • Received a form or survey
  • Received a gift
  • Received a LinkedIn message
  • Received a message
  • Received a tag or badge
  • Received a WhatsApp message
  • Received an email
  • Received an SMS message
  • Received sticker(s)
  • Received swag
  • Redeemed a reward
  • Registered as an event speaker
  • Registered for a webinar
  • Registered for an event
  • Requested a demo
  • Requested early access to a program
  • Requested sticker(s)
  • Requested swag
  • Sent a gift
  • Sent a LinkedIn message
  • Sent a message
  • Sent a WhatsApp message
  • Sent an email
  • Sent an SMS message
  • Signed up for trial
  • Started a group chat
  • Started a session
  • Started training
  • Submitted a feature request
  • Submitted a form
  • Submitted an idea
  • Subscribed to a newsletter
  • Tagged in media
  • Updated ticket or issue
  • Uploaded a photo
  • Uploaded a video
  • Viewed a page
  • Wrote a blog post or article
Didn't find your answer?Get in touch· Visit ourhelp center