Before You Begin
- This feature requires Admin support.
- The use of Zapier entails additional fees. Go to Zapier.com/pricing for more details.
- The Zapier connector and its use with any 3rd-party software is the customer's responsibility.
- The setup and implementation of zaps are the responsibility of the customer. Expert services for setting up zaps are available from Zapier.
- Zaps utilize Business Rule quotas. Each Zap counts towards one Workflow rule.
- Clarizen is not responsible for the Zapier service, and does not monitor the status. Go to status.zapier.com for more details.
- Issues arising from the use of Zapier are not managed or addressed by the Clarizen support channel or Clarizen Professional Services.
Introduction to Clarizen’s Zapier Connector
Zapier is a 3rd-party cloud-based solution that allows you to connect Clarizen One with 2000+ platforms using a simple no-code interface. The solution makes use of Clarizen’s Web Services, providing users with a lot of flexibility in setting up bi-directional workflows between Clarizen One and many popular systems such as ServiceNow, Zendesk, Hubspot, and more.
This connector is intended for Clarizen administrators to build simple workflows between their instances of Clarizen One and 3rd-party systems.
- Example Use Cases for Clarizen’s Zapier Connector
- Getting Started with Zapier
- Setting Up a Zap
- Scenario 1 - Clarizen One is the Trigger
- Scenario 2 - Clarizen One Is the Action in The Zap
- Troubleshooting Your Zap
Example Use Cases for Clarizen’s Zapier Connector
Clarizen’s Zapier connector is best used in cases when there is a trigger on one end, which then creates or updates an item on the other end. Here are a few examples of how Zapier is used by Clarizen customers:
- When a new request is created in Clarizen One, push a message to a user in Slack with all the corresponding details
- When a ticket is created in Zendesk, create a corresponding request object in Clarizen with all the corresponding details
- When a billable milestone is completed, trigger an invoice in Quickbooks
- When a risk is created, update a google sheet
Examples of use cases where it is not recommended to use the Zapier connector:
- Creating / synching calendar events in systems like Outlook or Gmail, with triggers or events in Clarizen One
- Using Zapier to continuously sync data across Clarizen and other systems
- Synching the entire WBS (Work Plan) of a project in Clarizen to another system
- Setting up workflows that will trigger many times at short intervals of time, for example 100+ times per day
Getting Started with Zapier
To use Clarizen’s app for Zapier, you need to have the following:
- A valid full user license to your Clarizen environment with admin privileges enabled
- A Zapier account (create an account here: https://zapier.com/sign-up/)
- Access to the Clarizen app for Zapier - please contact your Clarizen account manager for access to the connector
Setting Up a Zap
In Zapier terms, a ‘zap’ is a workflow built in Zapier that connects two or more systems. A zap is essentially composed of two parts, in an ‘if this, then that’ structure:
Part 1 - The Trigger (“if this..”)
Part 2 - The Action (“..then that”)
To begin, go to https://zapier.com/app/dashboard
Click the + icon or MAKE A ZAP.
In the top-left part of the screen, give your zap (workflow) a meaningful name.
In the trigger section, you must select the appropriate Zapier app. For example, if the trigger is Zendesk, you must look up Zendesk:
Scenario 1 - Clarizen One is the Trigger
Let’s imagine a scenario where Clarizen One is the triggering system in your zap. Type Clarizen and select the Zapier app for Clarizen One.
Note: If the Zapier app for Clarizen does not appear, please contact your Clarizen account manager to enable the app.
Select your Clarizen One account and follow the on-screen prompts to log in to your Clarizen One account.
In the next screen, you are prompted to fill out the fields to define the trigger:
For example, the trigger is the creation of a Change Request in Clarizen:
- You must use the API name of the field. If you are unsure of the API name of the field, you can look it up in the Configuration panel in Clarizen:
For picklists, you can find available values in the REST Metadata API Reference Guide, which is available here:
- Fields must be comma-separated.
- Do not include spaces between fields (e.g. Name,DueDate NOT Name,_DueDate).
- Do not add the $ before the field name, just the fieldname.
- The criteria determines when this zap is triggered.
- If Clarizen One is your trigger, then you must use the exact syntax that you would use in Clarizen to create a condition for a workflow, for example, $RequestType=”Change Request”
- You must use $ before field names.
If you have items in your Clarizen One environment that meet the condition defined, then testing the trigger will pull in data from Clarizen to Zapier when you press TEST TRIGGER:
The data that is pulled in from Clarizen and displayed in Zapier will be used as placeholders in the next section. For example, if your workflow pushes a Clarizen request to Slack, then you will be able to display the title and description of the request in Slack, because the first part of the zap now gives you access to these fields:
You have finished setting up Clarizen One as the trigger in your zap. You can now proceed to select another app (for example: Slack, Google Sheets, Zendesk, Gmail, etc.) for the second part of your zap.
Note: You should now notice a workflow rule created in Clarizen called Zapier Hook:
This is because creating a trigger in Zapier creates a corresponding Workflow in Clarizen that is triggered each time the condition is met. There is no need to manually enable or disable the workflow in Clarizen. Zapier will automatically enable/disable the workflow rule depending on whether you enable or disable the zap.
Scenario 2 - Clarizen One Is the Action in The Zap
In this scenario, we will consider that a different app is the trigger (for example, Zendesk), and Clarizen One is the action. For example, “if a ticket is created in Zendesk (trigger), then create a request in Clarizen (action)”.
In the action section of the zap, select the Clarizen One app, and the action event
Under the Action Event you have 4 options:
- Create Post - the action will be able to create a post in Clarizen
- Create Object - the action will be able to create an object in Clarizen, for example, a new Request, or a new Project
- Update Object - the action will be able to update an existing object in Clarizen, for example, a specific Request based on its ID
- Create Object from template - the action will be able to create an object from a template in Clarizen, such as a Project from a template stored in Clarizen
In the Customize Object section, choose the type of object in Clarizen that is to be created or updated, for example, a request:
Finally, you need to fill in the required fields and any additional fields you would like, using either a hard-coded value, or variables found in the first part of the zap. For example, to always give the request the title “request from Zendesk” each time the zap is triggered, use the following:
To use a variable for the title, click on the box below the Name field and select one of the options.
For criteria with picklists, you can find available values in the REST Metadata API Reference Guide, which is available here:
Keep in mind this is simply a placeholder. The real value will be determined each time the zap is triggered. For example, if a ticket is opened in Zendesk and the title of the ticket is “problem with my laptop”, then a request will be created in Clarizen with the title “problem with my laptop”.
When you are done filling in all required and any optional fields, click TEST & CONTINUE.
Note: This part of the process actually creates or updates an object in your Clarizen environment.
If the workflow is set up correctly, you should see the following success message:
Troubleshooting Your Zap
Below are some common mistakes that generate errors in Zapier, and prevent you from activating your zap.
Incorrect syntax in the Fields section
If Clarizen One is your trigger, make sure that in the fields section, you type the names of the fields without the $ symbol, and without any spaces between the names or commas.
A common mistake is to type $Title,_$Description,_$RequestType. If should be Title,Description,RequestType
Incorrect syntax in the Criteria section
In the Criteria section, be sure to use the exact syntax that you would use when building a Clarizen workflow:
A common mistake is to forget the $ before the field name in this section.
Note: For picklists, you can find available values in the REST Metadata API Reference Guide, which is available here:
Incorrect fields displayed in the Customize Object section
Assuming Clarizen One is the app you select in the second part of the zap (the action), then a common mistake is to select an object type, which pulls in field names, and then to change the object type, but the field names do not refresh automatically. For example, if we select Project as our object type, these are the fields that appear:
This is fine. But if we then change our mind and instead want to create a Request in Clarizen, then changing the object type to Request will continue to display Project fields, which is wrong!
The request object in Clarizen does not have the field Name. To correct this, scroll down to the bottom of the page and click Refresh Fields.
This will pull the correct fields for the object, and then you can populate the fields with values.