[GUIDE] How to use the Monday GraphQL API in Zaps with the Webhooks App

  • 24 February 2022
  • 0 replies
  • 1055 views

Userlevel 7
Badge +14

[guide] How to use the Monday GraphQL API in Zaps with the Webhooks App

 

Purpose

How to use the Webhooks app to interact with the Monday GraphQL API in Zaps.

 

App: Webhooks

Triggers/Actions: https://zapier.com/apps/webhook/integrations#triggers-and-actions

Help: https://zapier.com/apps/webhook/help

 

Monday API

Monday API Documentation: https://api.developer.monday.com/docs

 

GraphQL

What is GraphQL?

GraphQL is a flexible query language that allows you to return as much or as little data as you need.

Unlike REST APIs where there are multiple endpoints returning different data, GraphQL always exposes 1 endpoint and allows you to determine the structure of the returned data. (https://api.monday.com/v2)

In GraphQL there are 2 possible operations:

  1. queries
  2. mutations

A query performs the READ operation and does not change or alter any data.

A mutation is a special type of query that performs the CUD (Create, Update, Delete) operations to modify your data.

 

GraphQL Visual Interface (GraphiQL) is an in-browser tool for writing, validating, and testing GraphQL queries.

GraphiQL is available in the Playground here.

 

Learn more about GraphQL: https://api.developer.monday.com/docs/introduction-to-graphql

 

PREP

Get your Monday API Key: https://api.developer.monday.com/docs/authentication

Location: Profile/Settings > Developers > Developer (dropdown) > My Access Tokens

 

Activate Developer Mode in Monday Labs: https://support.monday.com/hc/en-us/articles/360002138760-What-is-monday-labs-

Location: Profile/Settings > monday.labs

 

JSON formatting examples for the field types: https://support.monday.com/hc/en-us/articles/360014205860-Zapier-JSON-Formatting-Examples

 

QUERY

EXAMPLE

NOTES

  1. This example is used to search a Monday Board by a column value “name” (aka Name of the Item), and return the Item ID and Name
  2. Replace the board_id with the numerical value of your Board ID
  3. Replace the column_value with the value you want to search for
  4. In the Headers, replace the Authorization value with your API Key
  5. Leave all other fields blank or as the default value.

 

CONFIG

 

RESULTS

 

MUTATE

EXAMPLE

NOTES

  1. This example is used to change an Item’s column value for the “date” column, and return the Item ID, Name, and Date value
  2. Replace the board_id with the numerical value of your Board ID
  3. Replace the item_id with the numerical value of your Item ID
  4. Replace the column_id with the internal value of your Column ID (see Developer Mode)
  5. Set the value for the ‘date’ type column in YYYY-MM-DD format
  6. In the Headers, replace the Authorization value with your API Key
  7. Leave all other fields blank or as the default value.

 

CONFIG

 

RESULTS

 


0 replies

Be the first to reply!

Reply