Integrate WhatsApp with ClickUp

Step by step

1. 1

   Create your WhatsApp instance on ZapZap API

   Go to the dashboard at app.zapzapapi.com, create an instance and scan the QR Code with the phone that will send the messages. Keep the account's instanceId, x-api-key and x-api-secret. Each active number costs R$15 per month on the prepaid model, and you start with a welcome credit when you create the account, subject to the current campaign.

2. 2

   Build an intermediate endpoint to receive the webhook

   ClickUp fires webhooks in its own format. Create a simple endpoint (for example in a serverless function or n8n) that receives the ClickUp payload, extracts the task name and status and then calls ZapZap API with your x-api-key and x-api-secret headers.

3. 3

   Open Automations in ClickUp

   Inside a Space, Folder or List, click the Automate button in the top right corner and choose Create Automation. You can also manage everything under Settings and then Automations.

4. 4

   Configure the trigger and the Call webhook action

   Under When (trigger) choose something like Status changes or Due date arrives. Under Then (action) select Call webhook, paste the URL of your intermediate endpoint and save. On every event, ClickUp will send the task data to that URL.

5. 5

   Test and activate in production

   Move a test task to the configured status and confirm the message arrives on WhatsApp. Adjust the text in your endpoint and replicate the Automation for other statuses or Lists as your team needs.

// ILLUSTRATIVE example. Check the real fields at https://api.zapzapapi.com/llms.txt
// Call made by your intermediate endpoint after receiving the ClickUp webhook
const res = await fetch(
  "https://api.zapzapapi.com/api/v1/{instanceId}/send/text",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": process.env.ZAPZAP_API_KEY,
      "x-api-secret": process.env.ZAPZAP_API_SECRET,
    },
    body: JSON.stringify({
      number: "5511999999999",
      text: "A task changed status in ClickUp: please review when you can.",
    }),
  }
);