Setting Up Asana Webhook Integration: 2 Easy Steps

on Asana, Project Management Tool, Tutorials, Webhook • October 18th, 2021 • Write for Hevo

Asana Webhook Integration - Featured Image

If managing your projects is something that gives you headache all the time, then it is the right time to switch to Asana. Asana is a Project Management platform that helps you plan, collaborate on, and track your projects, even remotely. It does not require all your team members to be available at the same time to assign the responsibilities. Moreover, it also helps you keep track of all the progress made by each of your team members.

Although Asana works incredibly well, it is always recommended to integrate it with Webhooks. Asana Webhook Integration enhances its functionalities and provides additional features to simultaneously maintain all your projects. Asana Webhook Integration notifies you of all the changes made in your projects by any of your team members. This way, you never miss any updates.

This article will introduce you to Asana and Webhooks. It will also introduce you to Asana Webhook Integration and will provide a comprehensive guide that you can use while setting up Asana Webhook Integration.

Table of Contents

Introduction to Asana

Asana logo
Image Source

Asana is a Software-as-a-Service (SaaS) platform for Project Management and Team Collaboration. It allows teams to manage projects and tasks all in one place. Teams may use Asana to create projects, allocate work to peers, set deadlines, and immediately communicate about assignments. It also provides additional reporting tools, file attachments, calendars, and other functions.

Asana API and Integrations

Asana made its API available to 3rd party developers in April 2012. Asana’s open API allows you to receive data from Asana, input data into Asana, and create automation from within Asana. This enables clients or 3rd party developers to build on the Asana platform and tailor it to their teams’ specific needs. Automating repetitive operations, chaining processes, automating task and project reporting, and syncing with databases or other tools are all common use cases.

The Asana API is a RESTful interface that allows users to change and retrieve data on the site. It leverages built-in HTTP features to take instructions and return responses and provides predictable URLs for accessing resources. This enables communication with a wide range of environments, including command-line utilities, browser plugins, and native apps.

For more information on Asana, click here.

Introduction to Webhook

Webhook logo

 A Webhook (sometimes called a web callback or HTTP push API) is a method for a computer to provide real-time data to other programs. A Webhook transfers data in real-time to other applications, so you get it straight away. You won’t have to poll for data as frequently as you would with typical APIs to get real-time results. As a result, Webhooks become substantially more efficient for both the provider and the consumer. The only negative of Webhooks is the time and effort required to set them up at first.

For more information on Webhook, click here.

Simplify Project Management using Hevo’s No-code Data Pipeline

Hevo Data, a No-code Data Pipeline helps to Load Data from any data source such as Databases, SaaS applications, Cloud Storage, SDKs, and Streaming Services and simplifies the ETL process. It supports 150+ data sources including Asana, etc., for free and is a 3-step process by just selecting the data source, providing valid credentials, and choosing the destination. Hevo loads the data onto the desired Data Warehouse, enriches the data, and transforms it into an analysis-ready form without writing a single line of code.

Its completely automated pipeline offers data to be delivered in real-time without any loss from source to destination. Its fault-tolerant and scalable architecture ensure that the data is handled in a secure, consistent manner with zero data loss and supports different forms of data. The solutions provided are consistent and work with different Business Intelligence (BI) tools as well.

Get Started with Hevo for free

Check out why Hevo is the Best:

  • Secure: Hevo has a fault-tolerant architecture that ensures that the data is handled in a secure, consistent manner with zero data loss.
  • Schema Management: Hevo takes away the tedious task of schema management & automatically detects the schema of incoming data and maps it to the destination schema.
  • Minimal Learning: Hevo, with its simple and interactive UI, is extremely simple for new customers to work on and perform operations.
  • Hevo Is Built To Scale: As the number of sources and the volume of your data grows, Hevo scales horizontally, handling millions of records per minute with very little latency.
  • Incremental Data Load: Hevo allows the transfer of data that has been modified in real-time. This ensures efficient utilization of bandwidth on both ends.
  • Live Support: The Hevo team is available round the clock to extend exceptional support to its customers through chat, email, and support calls.
  • Live Monitoring: Hevo allows you to monitor the data flow and check where your data is at a particular point in time.
Sign up here for a 14-day Free Trial!

Steps to Set Up Asana Webhook Integration

Asana Webhook Integration image
Image Source

Setting up Asana Webhook Integration is a 2 step process. Follow the steps below to set up Asana Webhook Integration:

Step 1: Make an HTTP POST Request

To begin, make a basic HTTP POST request, just as you would for any other resource. The confirmation handshake follows in the middle of this request. You’ll have to send a test POST to the target with an X-Hook-Secret header when a Webhook is formed.

To prove that this Webhook subscription is truly intended, the target must respond with a 200 OK or 204 No Content with a matching X-Hook-Secret header. This secret should be kept safe and used to authenticate future webhook event signatures.

Step 2: Acknowledge the Asana Webhook Confirmation Handshake

The status of the request will be returned with the POST request to create the Webhook. If you don’t acknowledge the Webhook’s confirmation handshake, it won’t set up, and you’ll get an error message when you try to establish it. You must be able to receive and complete the webhook while the POST request is in progress (in other words, have a server that can handle requests asynchronously).

NOTE: A 403 Forbidden status code will be returned for invalid hostnames such as localhost.

Given below is a code sample for the same:

import asana

client = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')

result = client.webhooks.create_webhook({'field': 'value', 'field': 'value'}, opt_pretty=True)

Body Parameter:

{
  "data": {
    "filters": [
      {
        "action": "changed",
        "fields": [
          "due_at",
          "due_on",
          "dependencies"
        ],
        "resource_subtype": "milestone",
        "resource_type": "task"
      }
    ],
    "resource": "12345",
    "target": "https://example.com/receive-webhook/7654?app_specific_param=app_specific_value"
  }
}

That’s it. You have successfully set up Asana Webhook Integration.

You can use the following code to get a Webhook for Asana Webhook Integration:

GET /webhooks/{webhook_gid}

This will return the full record for the given Webhook. Here, webhook_gid is a globally unique identifier for Webhook and is a required field. Given below is a code sample for the same:

import asana

client = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')

result = client.webhooks.get_webhook(webhook_gid, {'param': 'value', 'param': 'value'}, opt_pretty=True)

You can use the code given below to update a Webhook after successfully setting up Asana Webhook Integration:

PUT /webhooks/{webhook_gid}

Filters on an existing Webhook can be modified by sending a PUT request to the Webhook’s URL. The filters given in the PUT request will entirely overwrite the previous filters array in the Webhook. Given below is a code sample for the same:

import asana
 
client = asana.Client.access_token('PERSONAL_ACCESS_TOKEN')
 
result = client.webhooks.update_webhook(webhook_gid, {'field': 'value', 'field': 'value'}, opt_pretty=True)

Conclusion

The article introduced you to Asana and Webhook. It provided a comprehensive step-by-step guide on how to set up Asana Webhook Integration. It also provides you with code samples on how to update your Webhooks once you are done with setting up Asana Webhook Integration.

With the complexity involved in Manual Integration, businesses are leaning more towards Automated and Continous Integration. This is not only hassle-free but also easy to operate and does not require any technical proficiency. In such a case, Hevo Data is the right choice for you! It will help simplify Project Management. Hevo Data supports platforms like Asana, for free.

Visit our Website to Explore Hevo

Want to take Hevo for a spin? Sign Up for a 14-day free trial and experience the feature-rich Hevo suite first hand.

Share your experience of setting up Asana Webhook Integration in the comments section below!

No-Code Data Pipeline for Your Data Warehouse