How to integrate with Zapier

Zapier is extremely useful and fun to use app. In this tutorial, we'll walk through the triggers and actions that our Zapier integration offers - you can always use our API too.

In this case, you will create a Zap that will set up a new User.com user when a new row appears in one of your spreadsheets. Another way to use Zapier integrations is to trigger an event for a particular user or update his or her profile.

Before you start

1. Sign up for Zapier.
2. Make sure you have administrative rights to the User.com account. Only then you can grant Zapier access to the app.
3. If you want to send events using Zapier, make sure that the event and its attributes have already been created. If not, go to App Settings -> Events and App Setttings -> Event Attributes.)

Triggers

When choosing the trigger, simply type in "User.com" and click on the system's icon that appears on the list of apps. Choose the trigger you want to use.

Company created

This trigger will fire when a new company is created. It's useful for all kinds of "zap's" including tasks of account executives. In the next steps, choose the connection with your app and the application you will track. The sample collected by Zapier will include all the standard attributes of the company. You will be able to use all the downloaded attributes in the action and filter steps of your app.

New event

This trigger will fire when a user performs a selected event. It's flexible, because a given event can be generated at any point for any user using automation processes.

In the next steps, choose the connection with your app, the application you will track, and the event that will trigger the zap.The trigger will pass along all the standard attributes of the user as well as the attributes of the event. Then you will be able to use all the downloaded attributes in the action and filter steps of your app.

Create/Update company

This action requires at least one field: company name.If the system recognizes the name of the company or company ID provided in the form, it will update the existing one instead of creating a new one. You can include any standard or custom company attributes in the action form.

Create/Update user

This action requires at least one of two fields: ID or email.If you add a unique user ID that matches one of the users inside User.com, the existing user with that ID will be updated to include the fields that you've included in the action form. If you don't provide any info in a given field, the user will keep the old data.If you provide an email address that is already in the database, the system will match the data with the oldest user with that email.

If you provide both an email and a user ID and the ID is unique, a new user will be created even if other users with the same email already exist. If the ID is already in the database, the user with that ID will be assigned a new email address. 

Create an event

Choose an app and the event that you want to generate - always choose the app before the event, otherwise it won't work.Remember that you can only generate events that already exist in your app (meaning they have been triggered at least once or they have been added in the app settings section of your app).

In the action form, describe the event and its parameters as well as the user who should receive this event.

• When describing the event, you will be able to add any event attribute that has ever been used in any event (not only those that were used in this event).
• When describing the user, as in case of create/update user, you need to provide either the user ID or email. If you add a unique user ID which matches one of the users inside User.com, the existing user with that ID will get the event. If you provide an email address that is already in the database, the system will match the data with the oldest user with that email. If you include both an email and ID, and the ID is already in the database, the user with that ID will get the event.

Troubleshooting

1. If you want to generate events but can't find them on the list, make sure that you have created them in the app.
2. If your events are not correctly delivered, make sure the email address or ID match one of the users. It's best to use the create/update user action before generating an event action to make sure that the event goes through.
3. If you update contact and get a 404 error during testing, make sure that the example item Zapier is using to test the connection has the email field of some user in your database. Otherwise, User.com won't identify which user should be updated and which test was signalled as failed. The same rule applies to the event creation zap.
4. If your example can't be downloaded, make sure that you have at least one company/user/event/tag.