manychat-api

n8n community node for ManyChat API integration — manage subscribers, tags, custom fields, and send messages via WhatsApp, Instagram, and Messenger

Package Information

Downloads: 2 weekly / 56 monthly
Latest Version: 1.5.2
Author: Gustavo José Silva Melo

Available Nodes

ManyChat icon
ManyChat
Interact with ManyChat API to manage subscribers, tags, custom fields, and send messages

Documentation

n8n-nodes-manychat

This is an n8n community node that integrates ManyChat into your n8n workflows. It provides full access to the ManyChat API, allowing you to manage subscribers, tags, custom fields, bot fields, and send messages across WhatsApp, Instagram, and Facebook Messenger.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Via n8n UI

  1. Go to Settings > Community Nodes
  2. Select Install
  3. Enter n8n-nodes-manychat and confirm

Via npm (Self-hosted)

cd ~/.n8n/custom
npm install n8n-nodes-manychat

Credentials

You need a ManyChat API Key to use this node:

  1. Log in to your ManyChat account
  2. Go to Settings → API
  3. Click Generate your API Key
  4. Copy the generated key

⚠️ Note: A ManyChat Pro plan is required for API access.

Operations

Page (Bot)

Operation Description
Get Info Get page/bot information
Get Tags List all tags
Create Tag Create a new tag
Remove Tag Remove a tag by ID
Get Custom Fields List all custom fields
Create Custom Field Create a new custom field
Get Bot Fields List all bot fields
Create Bot Field Create a new bot field
Set Bot Field Set bot field value by ID
Set Bot Field by Name Set bot field value by name
Get Flows List all flows
Get Growth Tools List all growth tools
Get OTN Topics List One-Time Notification topics

Subscriber (Contact)

Operation Description
Get Info Get subscriber info by ID
Get Info by User Ref Get subscriber info by user_ref
Find by Name Search subscribers by name
Find by Custom Field Search subscribers by custom field value
Find by System Field Find subscriber by phone or email
Create Subscriber Create a new subscriber
Add Tag Add one or more tags to subscriber
Add Tag by Name Add tag to subscriber by tag name
Remove Tag Remove one or more tags from subscriber
Remove Tag by Name Remove tag from subscriber by tag name
Set Custom Field Set custom field value by field ID
Set Custom Field by Name Set custom field value by field name
Set Custom Fields Set multiple custom field values at once

Sending

Operation Description
Send Content Send content to subscriber (text, image, card, or raw JSON)
Send Content by User Ref Send content using user_ref
Send Flow Send a flow to subscriber

Usage Examples

Get subscriber information

  1. Add the ManyChat node to your workflow
  2. Select Resource: Subscriber
  3. Select Operation: Get Info
  4. Enter the Subscriber ID
  5. Execute the workflow

Add a tag to a subscriber

  1. Add the ManyChat node
  2. Select Resource: Subscriber → Operation: Add Tag by Name
  3. Enter the Subscriber ID and Tag Name
  4. Execute

Send a text message

  1. Add the ManyChat node
  2. Select Resource: Sending → Operation: Send Content
  3. Select Content Type: Text Message
  4. Enter the Subscriber ID, Message Text, and select a Message Tag
  5. Execute

Create a subscriber via API

Use the Create Subscriber operation with fields like:

  • whatsapp_phone: +5511999999999
  • email: contact@example.com
  • first_name: John
  • last_name: Doe

Bulk tag operations

The Add Tag and Remove Tag operations support bulk mode — you can add or remove multiple tags at once by providing a comma-separated list of tag IDs.

Message Tags

When using Send Content, you must specify a Message Tag for messages sent outside the 24-hour Facebook messaging window:

Tag Use Case
ACCOUNT_UPDATE Account, order, or payment updates
CONFIRMED_EVENT_UPDATE Confirmed event updates
POST_PURCHASE_UPDATE Post-purchase updates

API Rate Limits

The ManyChat API has rate limits. See the official documentation for details.

Compatibility

  • n8n: Version 1.0.0 or later
  • Node.js: Version 18.0.0 or later

Resources

License

MIT

Contributing

Contributions are welcome! Please open an issue or pull request on the GitHub repository.

Author

Created by Gustavo José Silva Melo — built with ❤️ for the n8n community.

Discussion