Install any skill in seconds. Free to start, no credit card required.
Get Started Free →ManyChat API integration with managed authentication. Manage subscribers, tags, custom fields, and send messages through Facebook Messenger. Use this skill when users want to manage ManyChat subscribers, send messages, add/remove tags, or work with custom fields and bot automation. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
.claude/skills/leoyeai-manychat/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-23 | ✗→✓ | ▲ Improved | 761% | 0% |
| case-24 | ✗→✓ | ▲ Improved | 386% | 0% |
| case-02 | ✗→✓ | ▲ Improved | 385% | 0% |
| case-07 | ✗→✓ | ▲ Improved | 243% | 0% |
| case-08 | ✗→✓ | ▲ Improved | 409% | 0% |
Access the ManyChat API with managed authentication. Manage subscribers, tags, custom fields, flows, and send messages through chat automation.
bash# Get page info python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/manychat/fb/page/getInfo') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
https://gateway.maton.ai/manychat/{native-api-path}Replace {native-api-path} with the actual ManyChat API endpoint path. The gateway proxies requests to api.manychat.com and automatically injects your API token.
All requests require the Maton API key in the Authorization header:
Authorization: Bearer $MATON_API_KEYEnvironment Variable: Set your API key as MATON_API_KEY:
bashexport MATON_API_KEY="YOUR_API_KEY"
Manage your ManyChat connections at https://ctrl.maton.ai.
bashpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections?app=manychat&status=ACTIVE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
bashpython <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'manychat'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
bashpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
Response:
json{ "connection": { "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80", "status": "ACTIVE", "creation_time": "2025-12-08T07:20:53.488460Z", "last_updated_time": "2026-01-31T20:03:32.593153Z", "url": "https://connect.maton.ai/?session_token=...", "app": "manychat", "metadata": {} } }
Complete the connection by providing your ManyChat API key through the connection URL.
bashpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If you have multiple ManyChat connections, specify which one to use with the Maton-Connection header:
bashpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/manychat/fb/page/getInfo') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If omitted, the gateway uses the default (oldest) active connection.
bashGET /manychat/fb/page/getInfo
Rate limit: 100 queries per second
Response:
json{ "status": "success", "data": { "id": 123456789, "name": "Page Name", "category": "Business", "avatar_link": "https://...", "username": "pagename", "about": "About text", "description": "Page description", "is_pro": true, "timezone": "America/New_York" } }
bashGET /manychat/fb/page/getTags
Rate limit: 100 queries per second
Response:
json{ "status": "success", "data": [ {"id": 1, "name": "VIP"}, {"id": 2, "name": "Customer"} ] }
bashPOST /manychat/fb/page/createTag Content-Type: application/json { "name": "New Tag" }
Rate limit: 10 queries per second
bashPOST /manychat/fb/page/removeTag Content-Type: application/json { "tag_id": 123 }
Rate limit: 10 queries per second. Removes tag from page and all subscribers.
bashPOST /manychat/fb/page/removeTagByName Content-Type: application/json { "tag_name": "Old Tag" }
Rate limit: 10 queries per second
bashGET /manychat/fb/page/getCustomFields
Rate limit: 100 queries per second
Response:
json{ "status": "success", "data": [ {"id": 1, "name": "phone_number", "type": "text"}, {"id": 2, "name": "purchase_count", "type": "number"} ] }
bashPOST /manychat/fb/page/createCustomField Content-Type: application/json { "caption": "Phone Number", "type": "text", "description": "Customer phone number" }
Rate limit: 10 queries per second
Field Types: text, number, date, datetime, boolean
bashGET /manychat/fb/page/getBotFields
Rate limit: 100 queries per second
bashPOST /manychat/fb/page/createBotField Content-Type: application/json { "name": "counter", "type": "number", "description": "Global counter", "value": 0 }
Rate limit: 10 queries per second
bashPOST /manychat/fb/page/setBotField Content-Type: application/json { "field_id": 123, "field_value": 42 }
Rate limit: 10 queries per second
bashPOST /manychat/fb/page/setBotFieldByName Content-Type: application/json { "field_name": "counter", "field_value": 42 }
Rate limit: 10 queries per second
bashPOST /manychat/fb/page/setBotFields Content-Type: application/json { "fields": [ {"field_id": 123, "field_value": "value1"}, {"field_name": "field2", "field_value": "value2"} ] }
Rate limit: 10 queries per second. Maximum 20 fields per request.
bashGET /manychat/fb/page/getFlows
Rate limit: 10 queries per second
Response:
json{ "status": "success", "data": { "flows": [ {"ns": "content123456", "name": "Welcome Flow", "folder_id": 1} ], "folders": [ {"id": 1, "name": "Main Folder"} ] } }
bashGET /manychat/fb/page/getGrowthTools
Rate limit: 100 queries per second
bashGET /manychat/fb/page/getOtnTopics
Rate limit: 100 queries per second
bashGET /manychat/fb/subscriber/getInfo?subscriber_id=123456789
Rate limit: 10 queries per second
Response:
json{ "status": "success", "data": { "id": 123456789, "name": "John Doe", "first_name": "John", "last_name": "Doe", "gender": "male", "profile_pic": "https://...", "subscribed": "2025-01-15T10:30:00Z", "last_interaction": "2025-02-01T14:20:00Z", "tags": [{"id": 1, "name": "VIP"}], "custom_fields": [{"id": 1, "name": "phone", "value": "+1234567890"}] } }
bashGET /manychat/fb/subscriber/findByName?name=John%20Doe
Rate limit: 10 queries per second. Maximum 100 results.
bashGET /manychat/fb/subscriber/findByCustomField?field_id=123&field_value=value
Rate limit: 10 queries per second. Works with Text and Number fields. Maximum 100 results.
bashGET /manychat/fb/subscriber/findBySystemField?email=john@example.com
bashGET /manychat/fb/subscriber/findBySystemField?phone=+1234567890
Rate limit: 50 queries per second. Set either email OR phone parameter.
bashGET /manychat/fb/subscriber/getInfoByUserRef?user_ref=123456
bashPOST /manychat/fb/subscriber/createSubscriber Content-Type: application/json { "first_name": "John", "last_name": "Doe", "phone": "+1234567890", "email": "john@example.com", "gender": "male", "has_opt_in_sms": true, "has_opt_in_email": true, "consent_phrase": "I agree to receive messages" }
Rate limit: 10 queries per second
Note: Importing subscribers with phone or email requires special permissions from ManyChat. Contact ManyChat support to enable this feature for your account.
bashPOST /manychat/fb/subscriber/updateSubscriber Content-Type: application/json { "subscriber_id": 123456789, "first_name": "John", "last_name": "Smith", "phone": "+1234567890", "email": "john.smith@example.com" }
Rate limit: 10 queries per second
bashPOST /manychat/fb/subscriber/addTag Content-Type: application/json { "subscriber_id": 123456789, "tag_id": 1 }
Rate limit: 10 queries per second
bashPOST /manychat/fb/subscriber/addTagByName Content-Type: application/json { "subscriber_id": 123456789, "tag_name": "VIP" }
Rate limit: 10 queries per second
bashPOST /manychat/fb/subscriber/removeTag Content-Type: application/json { "subscriber_id": 123456789, "tag_id": 1 }
Rate limit: 10 queries per second
bashPOST /manychat/fb/subscriber/removeTagByName Content-Type: application/json { "subscriber_id": 123456789, "tag_name": "VIP" }
Rate limit: 10 queries per second
bashPOST /manychat/fb/subscriber/setCustomField Content-Type: application/json { "subscriber_id": 123456789, "field_id": 1, "field_value": "+1234567890" }
Rate limit: 10 queries per second
bashPOST /manychat/fb/subscriber/setCustomFieldByName Content-Type: application/json { "subscriber_id": 123456789, "field_name": "phone_number", "field_value": "+1234567890" }
Rate limit: 10 queries per second
bashPOST /manychat/fb/subscriber/setCustomFields Content-Type: application/json { "subscriber_id": 123456789, "fields": [ {"field_id": 1, "field_value": "value1"}, {"field_name": "field2", "field_value": "value2"} ] }
Rate limit: 10 queries per second. Maximum 20 fields per request.
bashPOST /manychat/fb/subscriber/verifyBySignedRequest Content-Type: application/json { "subscriber_id": 123456789, "signed_request": "signed_request_token" }
Rate limit: 10 queries per second
bashPOST /manychat/fb/sending/sendContent Content-Type: application/json { "subscriber_id": 123456789, "data": { "version": "v2", "content": { "messages": [ { "type": "text", "text": "Hello! How can I help you today?" } ] } }, "message_tag": "CONFIRMED_EVENT_UPDATE" }
Rate limit: 25 queries per second
Message Tags: Required for sending outside the 24-hour messaging window
CONFIRMED_EVENT_UPDATEPOST_PURCHASE_UPDATEACCOUNT_UPDATEOTN (One-Time Notification):
json{ "subscriber_id": 123456789, "data": {...}, "otn_topic_name": "Price Drop Alert" }
bashPOST /manychat/fb/sending/sendContentByUserRef Content-Type: application/json { "user_ref": 123456, "data": { "version": "v2", "content": { "messages": [ { "type": "text", "text": "Welcome!" } ] } } }
Rate limit: 25 queries per second
bashPOST /manychat/fb/sending/sendFlow Content-Type: application/json { "subscriber_id": 123456789, "flow_ns": "content123456" }
Rate limit: 20 queries per second, maximum 100 per subscriber per hour
ManyChat uses a structured content format for sending messages:
json{ "version": "v2", "content": { "messages": [ { "type": "text", "text": "Your message here" } ] } }
json{ "version": "v2", "content": { "messages": [ { "type": "image", "url": "https://example.com/image.jpg" } ] } }
json{ "version": "v2", "content": { "messages": [ { "type": "text", "text": "Choose an option:", "quick_replies": [ {"type": "node", "caption": "Option 1", "target": "content123"}, {"type": "node", "caption": "Option 2", "target": "content456"} ] } ] } }
json{ "version": "v2", "content": { "messages": [ { "type": "text", "text": "Click a button:", "buttons": [ {"type": "url", "caption": "Visit Website", "url": "https://example.com"}, {"type": "flow", "caption": "Start Flow", "target": "content123"} ] } ] } }
javascript// Get page info const response = await fetch( 'https://gateway.maton.ai/manychat/fb/page/getInfo', { headers: { 'Authorization': `Bearer ${process.env.MATON_API_KEY}` } } ); const data = await response.json(); // Send a message const sendResponse = await fetch( 'https://gateway.maton.ai/manychat/fb/sending/sendContent', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.MATON_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ subscriber_id: 123456789, data: { version: 'v2', content: { messages: [{ type: 'text', text: 'Hello!' }] } } }) } );
pythonimport os import requests # Get page info response = requests.get( 'https://gateway.maton.ai/manychat/fb/page/getInfo', headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'} ) data = response.json() # Send a message send_response = requests.post( 'https://gateway.maton.ai/manychat/fb/sending/sendContent', headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'}, json={ 'subscriber_id': 123456789, 'data': { 'version': 'v2', 'content': { 'messages': [{'type': 'text', 'text': 'Hello!'}] } } } )
message_tag parameter is required when sending messages outside the 24-hour messaging window{"status": "success"} on successcurl -g when URLs contain brackets to disable glob parsingjq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments| Status | Meaning | |--------|---------| | 400 | Missing ManyChat connection | | 401 | Invalid or missing Maton API key | | 429 | Rate limited | | 4xx/5xx | Passthrough error from ManyChat API |
| Code | Meaning | |------|---------| | 2011 | Subscriber not found | | 2012 | User ref not found | | 3011 | Invalid message content | | 3021 | Message tag required | | 3031 | OTN topic not found |
MATON_API_KEY environment variable is set:bashecho $MATON_API_KEY
bashpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
manychat. For example:https://gateway.maton.ai/manychat/fb/page/getInfohttps://gateway.maton.ai/fb/page/getInfo| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-23 | fail→pass | 4,576 | 3,358 | -27% | 1 | 1 | 0% | 748 | 6,442 | +761% | 0 | 0 | — |
case-24 | fail→pass | 7,755 | 5,540 | -29% | 1 | 1 | 0% | 1,406 | 6,834 | +386% | 0 | 0 | — |
case-01 | fail→fail | 4,936 | 10,981 | +122% | 1 | 1 | 0% | 968 | 6,342 | +555% | 0 | 0 | — |
case-02 | fail→pass | 13,146 | 5,008 | -62% | 1 | 1 | 0% | 1,417 | 6,866 | +385% | 0 | 0 | — |
case-03 | fail→fail | 7,382 | 9,238 | +25% | 1 | 1 | 0% | 1,491 | 6,275 | +321% | 0 | 0 | — |
case-04 | pass→pass | 11,845 | 6,269 | -47% | 1 | 1 | 0% | 1,737 | 7,140 | +311% | 0 | 0 | — |
case-05 | pass→pass | 9,616 | 10,992 | +14% | 1 | 1 | 0% | 1,730 | 8,101 | +368% | 0 | 0 | — |
case-06 | pass→pass | 11,705 | 19,413 | +66% | 1 | 1 | 0% | 2,174 | 8,550 | +293% | 0 | 0 | — |
case-07 | fail→pass | 10,155 | 4,877 | -52% | 1 | 1 | 0% | 2,007 | 6,879 | +243% | 0 | 0 | — |
case-08 | fail→pass | 7,293 | 2,968 | -59% | 1 | 1 | 0% | 1,242 | 6,325 | +409% | 0 | 0 | — |
case-09 | fail→pass | 6,274 | 6,025 | -4% | 1 | 1 | 0% | 1,071 | 7,038 | +557% | 0 | 0 | — |
case-10 | fail→pass | 13,280 | 4,484 | -66% | 1 | 1 | 0% | 1,241 | 6,650 | +436% | 0 | 0 | — |
case-11 | fail→pass | 3,271 | 14,615 | +347% | 1 | 1 | 0% | 549 | 7,590 | +1283% | 0 | 0 | — |
case-12 | fail→pass | 6,651 | 6,314 | -5% | 1 | 1 | 0% | 1,190 | 7,047 | +492% | 0 | 0 | — |
case-13 | fail→pass | 3,971 | 2,672 | -33% | 1 | 1 | 0% | 711 | 6,247 | +779% | 0 | 0 | — |
case-14 | fail→pass | 7,057 | 4,928 | -30% | 1 | 1 | 0% | 1,135 | 6,629 | +484% | 0 | 0 | — |
case-15 | fail→pass | 6,397 | 6,591 | +3% | 1 | 1 | 0% | 947 | 6,875 | +626% | 0 | 0 | — |
case-16 | fail→pass | 5,330 | 4,137 | -22% | 1 | 1 | 0% | 840 | 6,529 | +677% | 0 | 0 | — |
case-17 | fail→pass | 10,262 | 5,495 | -46% | 1 | 1 | 0% | 1,601 | 6,760 | +322% | 0 | 0 | — |
case-18 | fail→pass | 4,274 | 3,596 | -16% | 1 | 1 | 0% | 806 | 6,421 | +697% | 0 | 0 | — |
case-19 | fail→pass | 6,289 | 3,144 | -50% | 1 | 1 | 0% | 1,156 | 6,413 | +455% | 0 | 0 | — |
case-20 | fail→pass | 6,512 | 5,120 | -21% | 1 | 1 | 0% | 1,325 | 6,942 | +424% | 0 | 0 | — |
case-21 | fail→pass | 7,000 | 5,247 | -25% | 1 | 1 | 0% | 1,380 | 6,989 | +406% | 0 | 0 | — |
case-22 | fail→pass | 6,922 | 3,789 | -45% | 1 | 1 | 0% | 1,219 | 6,616 | +443% | 0 | 0 | — |
case-25 | fail→pass | 6,086 | 3,113 | -49% | 1 | 1 | 0% | 828 | 6,262 | +656% | 0 | 0 | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 25 cases were attempted, and 22 counted toward the lift figure. The other 3 produced results that are not comparable between the two arms, so they are excluded from the headline rather than averaged into it. The headline lift of +80 percentage points is the difference between those two pass rates over the 22 comparable cases.
Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.
Other measured skills in the registry, with their headline benchmark lift.