Ask the Community
Groups
Setting up an Asana zap in Zapier - Connect IT Community | Kaseya
<main> <article class="userContent"> <p><em>For partners subscribed to Select or Enterprise plans.</em></p> <p>Introduction</p> <p>With a Zapier account, you can create workflows that will send webhook notifications to Asana as tasks when specific events occur in IT Glue. For an introduction to workflows, refer to our <a rel="nofollow" href="https://kaseya.vanillacommunities.com/kb/articles/aliases/itglue/hc/en-us/articles/360004933677">Quick guide for workflows</a>.</p> <p>In this article, we will refer to the JSON API - a universal connector for data on the internet. JSON API is a specification for how a client should request that resources be fetched or modified and how a server should respond to those requests. You don’t have to know anything beyond that to begin experimenting with this feature.</p> <p>Prerequisites </p> <ul><li>You must have Manager or Administrator access to configure IT Glue workflows.</li> <li>You need a Zapier account and an Asana account.</li> </ul><p>Instructions </p> <h3 data-id="configuring-a-webhook-url">Configuring a webhook URL</h3> <p>This integration requires a webhook URL to post data to. The following steps will show you how to get the URL from Zapier.</p> <ol><li>Log in to your Zapier account and click the <img src="https://us.v-cdn.net/6032361/uploads/migrated/2QH3CEV56241/make-a-zap.png" alt="Make a Zap" width="92" height="30" class="embedImage-img importedEmbed-img"></img> button. A "zap" is a specific link between apps that you've connected in Zapier.</li> <li>On the <strong>Choose a Trigger App</strong> screen, choose <strong>Webhooks by Zapier</strong>.<br><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/TMD1SRV64JL3/zapier-webhooks.png" alt="" class="embedImage-img importedEmbed-img"></img></li> <li>On the <strong>Select Webhooks by Zapier Trigger</strong> screen, choose <strong>Catch Hook</strong>.<br><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/BDBFXTICPB7E/catch-hook.png" alt="" class="embedImage-img importedEmbed-img"></img></li> <li>On the <strong>Connect Webhooks by Zapier</strong> screen, copy the webhook URL.<br><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/W6J8ALAG04CU/set-up-webhook.png" alt="" class="embedImage-img importedEmbed-img"></img></li> <li>Leave this window open.</li> </ol><h3 data-id="setting-up-a-workflow">Setting up a workflow</h3> <p>The next step is to determine the specific IT Glue event that will trigger an action.</p> <ol><li>Log in to IT Glue and navigate to <strong>Account > Workflows</strong>. Then, click on the green <strong>+ New</strong> button. <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/25W01RR1BM8N/workflows-it-glue.png" alt="Workflows___IT_Glue.png" class="embedImage-img importedEmbed-img"></img></p> </li> <li>Choose a workflow trigger:<br><ul><li> <strong>Documents</strong> - Triggers when a document is published or updated</li> <li> <strong>Flag</strong> - Triggers when a flag is added, updated, or removed from a document</li> <li> <strong>Passwords</strong> - Triggers when a password is added or updated</li> <li> <strong>Domain Expirations</strong> - Triggers when the specified lead time is met on a domain's expiration date</li> <li> <strong>SSL Expirations</strong> - Triggers when the specified lead time is met on a SSL expiration date</li> <li> <strong>Configuration Expirations</strong> - Triggers when the specified lead time is met on a configuration's (warranty) expiration date</li> <li> <strong>Flexible Asset Expirations</strong> - Triggers when the specified lead time is met on a flexible asset's expiration date</li> </ul></li> <li>Enter the required information for your chosen trigger: <ul><li> <strong>Trigger Name</strong>: Enter a descriptive name for the notification. The name will be shown in the workflows management page and should be globally unique across workflows to make identification easy. <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/YQTHM6XN2LPY/workflows-trigger-name.png" alt="Workflows_Trigger_Name.png" class="embedImage-img importedEmbed-img"></img></p> </li> <li> <strong>Notification Failure Email</strong>: If there is a bounce back from the notification, an email will be sent to this email address from notifications@itglue.com <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/SO3SKEXJI2NS/workflows-failure-email.png" alt="Workflows_Failure_Email.png" class="embedImage-img importedEmbed-img"></img></p> </li> <li> <strong>Notify At (Lead Time)</strong>: Only applies to expiration-based triggers. Specify the number of days in advance that you want to be notified when an asset is nearing its expiration. <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/J1YT47UNNC8M/workflows-it-glue-6.png" alt="Workflows___IT_Glue-6.png" class="embedImage-img importedEmbed-img"></img></p> </li> <li> <strong>Also notify on assets that:</strong> <ul><li> <strong>Expire sooner than the lead time: </strong>This will schedule a one-time job that will notify you of existing assets that are about to expire. Click the <strong>Estimate How Many</strong> button to estimate how many notifications will be triggered when the first job runs. Depending on how much data you have, this might be a large number. Estimates may increase slightly if the below is checked as well.</li> <li> <strong>Have already expired:</strong> This will schedule a one-time job that will notify you of existing assets that are already expired. After the first job runs, edit the workflow so that it fits your business needs. For example, you may decide not to be notified when configuration items that are past their warranty date are uploaded. <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/5H6YEZZOB702/workflows-it-glue-3.png" alt="Workflows___IT_Glue-3.png" class="embedImage-img importedEmbed-img"></img></p> </li> </ul><div> <strong>Note: </strong>This expiration-based trigger is only required in the <strong>Domain Expiration</strong>, <strong>SSL Expiration</strong>, <strong>Configuration Expiration</strong>, and <strong>Flexible Asset Expiration</strong> workflows.</div> </li> </ul></li> <li>To add a filter, click the <strong>+ Filter</strong> button (left side of the screen) and select your filter criteria using the drop-downs. To add additional filter criteria, click the plus icon. <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/O5M0LFOZASSU/workflows-it-glue-5.png" alt="Workflows___IT_Glue-5.png" class="embedImage-img importedEmbed-img"></img></p> </li> <li>Click on <strong>Webhook</strong>.<br><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/M0KTIMHA86DN/webhook-choose-action.png" alt="Webhook_Choose_Action.png" class="embedImage-img importedEmbed-img"></img></li> <li>Configure the action to create the JSON payload that will be passed to the webhook when the trigger condition is met.</li> </ol><ul><li> <strong>Action Name</strong> - Enter a descriptive name for the action (e.g. Notify in Asana task 10 days in advance).</li> <li> <strong>Webhook URL</strong> - Enter the Webhook URL copied from Zapier.</li> <li> <strong>JSON Payload</strong> - Enter a key/value pair. Use multiple key/value pairs to split data across multiple fields (e.g. task name and task notes). <div> <strong>Note:</strong> This key/value pair includes variables that will pull values from the asset that is triggering the notification. The available variables are listed at the bottom of the screen when you click <strong>"Need Help? Click Here to See Available Variables"</strong>.</div> <p><img src="https://us.v-cdn.net/6032361/uploads/migrated/GA6DAXOPZLP6/1.png" alt="1.png" class="embedImage-img importedEmbed-img"></img></p> </li> <li>Click <strong>Next</strong>.</li> <li>Click the <strong>Test Action</strong> button to perform the job your action is set to do with some test data. <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/RDKWNXXAN0WB/workflows-test-action.png" alt="Workflows_Test_Action.png" class="embedImage-img importedEmbed-img"></img></p> </li> <li>Turn your workflow <strong>ON</strong> and then click <strong>Finish</strong> to save all your changes. <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/BBSMJ5S5RANB/workflows-it-glue-7.png" alt="Workflows___IT_Glue-7.png" class="embedImage-img importedEmbed-img"></img></p> </li> </ul><h3 data-id="configuring-the-asana-action">Configuring the Asana action</h3> <p>Now, configure the action in Asana that should occur after a notification is triggered.</p> <ol><li>In Zapier, choose <strong>Asana</strong> as the Action.</li> <li>Then choose <strong>Create task</strong> as the action and confirm by clicking on the <strong>Continue</strong> button. <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/GS13W5RD12EN/select-asana-action.png" alt="" class="embedImage-img importedEmbed-img"></img></p> </li> <li>Select your Asana account and confirm the choice by clicking on <strong>Continue</strong>.</li> <li>Grant Zapier permissions to access your Asana account by clicking <strong>Allow</strong> in the pop-up window. <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/RT48QK1NKE6O/asana-permission.png" alt="" class="embedImage-img importedEmbed-img"></img></p> </li> <li>Create a template to ‘map’ the information you want to send from the JSON payload to create a task in Asana. Some fields will allow you to populate values from your Asana account (e.g. Workspace/Organization, Project). <p><br><img src="https://us.v-cdn.net/6032361/uploads/migrated/51X3ANPZOG3B/set-up-asana-task.png" alt="Set_up_Asana_task.png" class="embedImage-img importedEmbed-img"></img></p> </li> <li>Click the <strong>Continue</strong> button at the bottom of the screen. Zapier will ask you to <strong>test</strong> the zap. Follow the instructions to test that everything is working properly.</li> <li>Click on the <strong>Finish</strong> button.</li> <li>Turn the zap on by clicking on the grey switch and to start passing information from IT Glue to Asana. Make sure the notification is <strong>ON</strong> in both IT Glue and Zapier.</li> </ol><h3 data-id="testing-the-notification">Testing the notification</h3> <ol><li>In IT Glue, click the <strong>Send test</strong> button to send a test notification to Asana via Zapier.</li> <li>Open Asana and look for the notification. You may have to refresh the Asana browser window to see the new task.</li> </ol><p>If the notification goes through, the connection has been established.</p> <p>After turning the zap on in Zapier and the workflow on in IT Glue, your team will start to receive notifications to Asana within the next 24 hours. Note that notifications based on document or password triggers will be sent in real time.</p> <p>If you ever want to change the Zapier integration, just go to <a href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Fzapier.com%2Fapp%2Fdashboard" rel="noopener noreferrer nofollow">your Zapier dashboard</a> and make adjustments as needed. You can also check out <a href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Fzapier.com%2Fhelp%2Fasana%2F" rel="noopener noreferrer nofollow">Get Started with Asana on Zapier</a> to learn more about what's possible with a Zapier-Asana integration.</p> </article> </main>