---
title: GREEN-API for WhatsApp
slug: green-api
image: https://make-cxp-documentation.ams3.digitaloceanspaces.com/apps-center-icons/PREVIEW_green-api.png
docTags: 
createdAt: 2025-08-18T14:45:03.630Z
---

::::VerticalSplit{layout="left"}
:::VerticalSplitItem
::Image[]{src="https://api.archbee.com/api/optimize/4CkrlJIBl1di_p1x71ery-FRAltplHkJ-fThX-N6EAF-20250819-130824.png" size="50" width="800" height="800" position="center" showCaption="false"}
:::

:::VerticalSplitItem
GREEN-API is an official API that enables businesses to automate communication and interact with WhatsApp. With the GREEN-API for WhatsApp app in Make, you can send messages, files, contacts, location messages, polls, and media statuses. You can also forward messages, receive chat histories and contact information, create and manage groups, manage message queues, archive chats, and download files in your GREEN-API account.
:::
::::

# Requirements

To use the GREEN-API for WhatsApp app in Make, you must have a [GREEN-API account](https://console.green-api.com/registration).

# Connect GREEN-API for WhatsApp and Make&#x20;

To get started, you must first create a connection between GREEN-API for WhatsApp and Make, allowing the two services to communicate.

To create the connection, you need to:

::::WorkflowBlock
:::WorkflowBlockItem
[Obtain an ID instance and API Token in your GREEN-API account.](docId\:vOJiYCVtj1NomlJsPr5Qf)
:::

:::WorkflowBlockItem
[Create the connection in Make.](docId\:vOJiYCVtj1NomlJsPr5Qf)
:::
::::

## Obtain your ID instance and API key instance in GREEN-API

Before you create the connection in Make, you should first obtain an ID instance and API key instance in your GREEN-API account.

To obtain the instande ID and API key instance:

::::WorkflowBlock
:::WorkflowBlockItem
Log in to your GREEN-API account.
:::

:::WorkflowBlockItem
In the left sidebar, click **Instances**.
:::

:::WorkflowBlockItem
Click **Create an instance** and select a tariff.
:::

:::WorkflowBlockItem
Once your instance is created, copy the **idInstance** and **apiTokenInstance**, then store them in a safe place.
:::

:::WorkflowBlockItem
To authenticate your instance, scroll down and click **Get QR**.

::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/yMTiGioqP4xBgR9rmRz71_image.png" size="70" width="1286" height="1076" position="center" showCaption="false"}
:::

:::WorkflowBlockItem
Scan the generated QR via WhatsApp:

**Settings&#x20;**>**&#x20;Linked devices&#x20;**>**&#x20;Link device**.
:::
::::

Now your created instance is authorized. You'll use the copied and stored values in the **ID Instance** and **API Token Instance** connection fields in Make.

## Create the connection in Make&#x20;

Once you have your ID instance and API key instance, you're ready to create the connection in Make.&#x20;

To create the connection:

::::WorkflowBlock
:::WorkflowBlockItem
Log in to your Make account, add a GREEN-API for WhatsApp module to your scenario, and click **Create a connection**.
:::

:::WorkflowBlockItem
Optional: In the ​​**Connection name​​** field, enter a name for the connection.
:::

:::WorkflowBlockItem
In the ​​**ID Instance** field, enter the **idInstance** you copied from your GREEN-API account.
:::

:::WorkflowBlockItem
In the ​​**API Token Instance** field, enter the **apiTokenInstance** you copied from your GREEN-API account.
:::

:::WorkflowBlockItem
Click **Save**.
:::

:::WorkflowBlockItem
If prompted, authenticate your account and confirm access.
:::
::::

You've successfully created the connection and can now use the GREEN-API for WhatsApp app in your scenarios. If you want to make changes to your connection in the future, follow the steps [here](https://help.make.com/connect-an-application#tN2pJ).

# GREEN-API for WhatsApp modules

After connecting to the GREEN-API for WhatsApp app, you can use the following types of modules to build your scenarios.&#x20;

:::ExpandableHeading
**Trigger**

- Watch Incoming Webhooks
- Watch All Messages Webhooks
:::

:::ExpandableHeading
**Send**

- Send a Message
- Send a File by URL
- Send a File by Upload
- Upload a File
- Send a Contact
- Send a Location Message
- Send a Poll
- Forward Messages
:::

:::ExpandableHeading
**Journal**

- Get Chat History
- Get a Message
- Get Last Outgoing Messages
- Get Last Incoming Messages
:::

:::ExpandableHeading
**Groups**

- Create a Group
- Update a Group Name
- Set a Group Picture
- Get a Group Data
- Add a Participant to a Group
- Remove a Group Participant
- Leave a Group
- Set a Group Admin
- Remove an Admin
:::

:::ExpandableHeading
**Queue**

- Show a Messages Queue
- Clear a Messages Queue
:::

:::ExpandableHeading
**Statuses**

- Send a Text Status
- Send a Voice Status
- Send a Media Status
- Delete a Status
:::

:::ExpandableHeading
**Service**

- Check Whatsapp
- Get an Avatar
- Get the Contacts
- Get a Contact Info
- Delete a Message
- Edit a Message
- Unarchive a Chat
- Set a Dissapearing Chat
- Read a Chat
:::

:::ExpandableHeading
**Settings**

- Get the Settings
- Set the Settings
- Set a Profile Picture
- Get Wa Settings
:::

:::ExpandableHeading
**Receiving**

- Download a File
:::

# Templates

You can look for GREEN-API for WhatsApp templates in [Make's template gallery](https://www.make.com/en/templates), where you'll find thousands of pre-created scenarios.

# GREEN-API for WhatsApp resources

- [GREEN-API documentation](https://green-api.com/en/docs/api/)

