Maytapi icon

Maytapi

Integrate with Maytapi WhatsApp Unofficial API

Actions55

Account → Add Phone

AI-generated

Overview

The "Add Phone" operation under the "Account" resource in this Maytapi node allows users to add a new phone number to their WhatsApp product instance. This is useful when you want to register additional phone numbers for sending and receiving WhatsApp messages through the Maytapi API. The phone number can be optionally provided upfront or set later when scanning the QR code.

Practical scenarios include:

  • Adding a new WhatsApp phone number to your existing Maytapi product to expand communication channels.
  • Automating the onboarding of new phone numbers into your WhatsApp messaging system.
  • Managing multiple WhatsApp instances programmatically within an n8n workflow.

Properties

Name Meaning
Phone ID Source (Not applicable for Account resource) Method to provide Phone ID: from credentials or custom (hidden for Account resource).
Phone ID (Not applicable for Account resource) Custom Phone ID string if "Custom" source selected.
Phone Number Optional phone number to add to the product, formatted as a string without country code prefix like "+". If omitted, it will be set when the QR code is scanned.

Note: For the "Add Phone" operation specifically, only the Phone Number property is relevant and used.

Output

The output JSON contains the response from the Maytapi API after attempting to add the phone number. It typically includes success status and details about the added phone or any error messages.

Example output structure:

{
  "success": true,
  "message": "Phone added successfully",
  "phoneId": "12",
  "number": "905301234567"
}

No binary data is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Maytapi WhatsApp Unofficial API.
  • The node uses the Maytapi REST API endpoint https://api.maytapi.com/api/addPhone to add the phone.
  • Proper configuration of the API key credential in n8n is necessary.
  • Network access to the Maytapi API service must be available.

Troubleshooting

  • Missing Phone ID Error: Although not directly required for this operation, other operations require a Phone ID. Ensure that the API key credential includes a valid Phone ID or specify a custom one if needed.
  • Invalid Phone Number Format: Provide the phone number without "+" or country code prefixes that are not supported. Use the format shown in the placeholder (e.g., "905301234567").
  • API Errors: If the API returns errors, check the validity of the API key, product subscription status, and whether the phone number is already registered.
  • Network Issues: Ensure your server can reach the Maytapi API endpoint without firewall restrictions.

Links and References

This summary focuses exclusively on the "Account" resource's "Add Phone" operation as requested.

Discussion