Maytapi icon

Maytapi

Integrate with Maytapi WhatsApp Unofficial API

Actions55

Group → Create Group

AI-generated

Overview

This node integrates with the Maytapi WhatsApp Unofficial API to manage WhatsApp groups and other related resources. Specifically, the Create Group operation allows users to create a new WhatsApp group by specifying the group name, initial participants, and optional settings such as sending invitation messages and setting a group profile picture.

This node is beneficial in scenarios where automation of WhatsApp group creation is needed, such as onboarding new teams, managing customer support groups, or organizing event-specific chat groups programmatically.

Example use case:
Automatically create a WhatsApp group for a new project team, add all team members' phone numbers, send them a welcome message, and optionally set a group image.

Properties

Name Meaning
Phone ID Source Select how to provide the Phone ID: either "From Credentials" (uses stored credentials) or "Custom" (enter manually).
Phone ID The WhatsApp instance Phone ID to use when "Custom" Phone ID Source is selected. Required if custom source is chosen.
Group Name The name of the WhatsApp group to create.
Phone Numbers Comma-separated list of phone numbers (without @c.us suffix) to add as initial participants in the group.
Send Invite Boolean flag indicating whether to send invitation messages to the added group members. Defaults to true.
Invitation Message Custom message text to include in the group invitations if "Send Invite" is enabled. Optional.
Group Image URL (Optional) URL of an image to set as the group's profile picture. Optional.

Output

The node outputs a JSON object representing the response from the Maytapi API after attempting to create the group. This typically includes details about the newly created group such as its ID, name, participants, and status of the invitations sent.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Maytapi WhatsApp API account with valid API credentials.
  • The node expects an API key credential configured in n8n to authenticate requests.
  • The Phone ID must be provided either via credentials or manually as input.
  • Internet access to the Maytapi API endpoint (https://api.maytapi.com/api) is required.

Troubleshooting

  • Error: "Phone ID is required."
    Occurs if no Phone ID is provided either in credentials or as a custom input. Ensure that the Phone ID is correctly set in credentials or entered manually when using the custom option.

  • Invalid phone numbers format
    Phone numbers must be provided without the @c.us suffix and separated by commas. Incorrect formatting may cause API errors.

  • Invitation message issues
    If "Send Invite" is enabled but the invitation message is empty, the default invitation message will be used. To customize, provide a non-empty invitation message.

  • Group image URL invalid or inaccessible
    If a group image URL is provided but the image cannot be fetched or is not a valid image, the API might reject the request or ignore the image.

  • API rate limits or authentication errors
    Ensure your API key is valid and has sufficient permissions. Check Maytapi service status if requests fail unexpectedly.

Links and References

Discussion