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: [email protected]
• 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

• ManyChat API Documentation
• ManyChat Help Center
• n8n Documentation
• n8n Community Forum

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.