Skip to main content
The Create Group and Add Chat ID API allows you to create new WhatsApp groups or update existing ones by adding chat IDs. If a group exists, contacts are appended to it. If the group doesn’t exist and the create flag is enabled, a new group will be created.
Do not use this API for spam or bulk messaging. Misuse may result in account bans.

​
Endpoint

POST https://api.eazybe.com/v2/cloud/group

​
Authentication

You need to obtain the Organization Auth Token from your EazyBe Workspace.
1

Access EazyBe Workspace

Go to workspace.eazybe.com
2

Navigate to Organization Page

An admin needs to access the Organization page.
3

Copy Auth Token

The Organization Auth Token will be displayed on this page. Copy it for API use.

​
Headers

HeaderTypeDescription
Content-Typestringapplication/json
AuthorizationstringBearer {YOUR_ORGANIZATION_AUTH_TOKEN}

​
Request Payload

The API requires the following fields:
FieldTypeRequiredDescription
groupNamestringYesName of the group to create or update
contactsarrayYesList of phone numbers to add (international format)
createbooleanNoCreate group if it doesn’t exist (defaults to false)

​
Example Payload

{
  "groupName": "Sales Team",
  "contacts": [
    "911234567891",
    "911234567892",
    "911234567893"
  ],
  "create": true
}

​
Code Example (Node.js)

const axios = require('axios');

const config = {
  method: 'post',
  url: 'https://api.eazybe.com/v2/cloud/group',
  headers: {
    'Authorization': 'Bearer YOUR_ORGANIZATION_AUTH_TOKEN',
    'Content-Type': 'application/json'
  },
  data: {
    groupName: 'Sales Team',
    contacts: [
      '911234567891',
      '911234567892',
      '911234567893'
    ],
    create: true
  }
};

axios(config)
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

​
Response

​
Success Response (200 OK)

{
  "status": true,
  "message": "Group created and chat IDs added successfully."
}

​
Error Responses

Status CodeDescription
400Invalid request data
403Inactive cloud session
404Group not found (when create is false)
500Group creation failed

​
Best Practices

Active Cloud Session

Ensure your cloud session is active before making API calls

Create Flag

Set create: true to automatically create groups that don’t exist

International Format

Use international phone number format (e.g., 911234567891)

Valid Token

Maintain a valid Organization Auth Token
If you have any questions or need further assistance, feel free to reach out to us at [email protected]. We’re happy to help!