Catnip website screenshot

Catnip

Catnip Inc is the company behind Chatfuel, an AI-powered business messaging and chatbot automation platform for WhatsApp, Instagram, Facebook Messenger, TikTok and an embeddable website chat widget. Chatfuel lets businesses and agencies build conversational flows, run Meta click-to-WhatsApp ad funnels, qualify leads, book appointments and automate customer support with AI agents. Its developer surface is small and shrinking: the only currently documented API is a Contacts API that bulk-imports up to 1,000 phone numbers into an automation using a Bearer token from Settings, while the older Broadcasting API on api.chatfuel.com and Dashboard API on dashboard.chatfuel.com remain live on the wire but lost their documentation when the docs.chatfuel.com developer help centre was retired. Chatfuel publishes no OpenAPI, but it does serve an llms.txt and a real remote MCP documentation server on its academy docs host.

Catnip publishes 3 APIs on the APIs.io network. Tagged areas include Company, Chatbots, Messaging, Conversational AI, and Marketing Automation.

Catnip’s developer surface includes documentation, API reference, getting-started guide, support, engineering blog, changelog, pricing, and 20 more developer resources.

44.5/100 developing ▲ 17.4 Agent 30/100 agent aware Full breakdown ↓
scored 2026-08-17 · rubric v0.11.0
AccessFreemiumSelf serveFree trial
3 APIs 1 MCP Servers
CompanyChatbotsMessagingConversational AIMarketing AutomationFacebook MessengerInstagramWhatsAppTikTokCustomer EngagementLead Qualification

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-17 · rubric v0.11.0
Composite quality — 44.5/100 · developing
Contract Quality 0.0 / 25
Developer Ergonomics 12.2 / 20
Commercial Clarity 14.7 / 20
Operational Transparency 6.8 / 13
Governance 1.5 / 12
Discoverability 9.3 / 10
Agent readiness — 30/100 · agent aware
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 10
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/catnip: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 3

Individual APIs this provider publishes, each with its own machine-readable definition.

Chatfuel Contacts API

Bulk-create WhatsApp contacts inside a Chatfuel automation. POST a list of up to 1,000 E.164 phone numbers plus a contact_data.properties map of custom attributes applied to eve...

Chatfuel Broadcasting API

Programmatically send messages and trigger flows/blocks to a specific bot user on Messenger, Instagram, or WhatsApp. POST to the send endpoint with the bot's unique chatfuel_tok...

Chatfuel Dashboard API

Manage Chatfuel bots and their Facebook page bindings. Create empty bots, clone content between bots, generate role-scoped invite links (ADMIN, EDITOR, MARKETER, OPERATOR, VIEWE...

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

catnip-mcp.yml

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

Catnip Plans Pricing

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Catnip Rate Limits

2 limits

RATE LIMITS

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Catnip Authentication

apiKey/http · 3 schemes

SECURITY

Catnip Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Resources

Get Started 3

Portal, sign-up, and the first successful call

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 3

Authentication, authorization, and security posture

Operate 5

Status, limits, changes, and where to get help

Commercial 4

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: catnip
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: true
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  - plans
  generated: '2026-08-13'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/catnip.png
name: Catnip
description: 'Catnip Inc is the company behind Chatfuel, an AI-powered business messaging and chatbot automation platform
  for WhatsApp, Instagram, Facebook Messenger, TikTok and an embeddable website chat widget. Chatfuel lets businesses and
  agencies build conversational flows, run Meta click-to-WhatsApp ad funnels, qualify leads, book appointments and automate
  customer support with AI agents. Its developer surface is small and shrinking: the only currently documented API is a Contacts
  API that bulk-imports up to 1,000 phone numbers into an automation using a Bearer token from Settings, while the older Broadcasting
  API on api.chatfuel.com and Dashboard API on dashboard.chatfuel.com remain live on the wire but lost their documentation
  when the docs.chatfuel.com developer help centre was retired. Chatfuel publishes no OpenAPI, but it does serve an llms.txt
  and a real remote MCP documentation server on its academy docs host.'
url: https://raw.githubusercontent.com/api-evangelist/catnip/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- 500-global
x-tier: stub
x-tier-reason: portfolio-lead
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-08-13'
tags:
- Company
- Chatbots
- Messaging
- Conversational AI
- Marketing Automation
- Facebook Messenger
- Instagram
- WhatsApp
- TikTok
- Customer Engagement
- Lead Qualification
apis:
- name: Chatfuel Contacts API
  description: Bulk-create WhatsApp contacts inside a Chatfuel automation. POST a list of up to 1,000 E.164 phone numbers
    plus a contact_data.properties map of custom attributes applied to every contact in the request; the automation_id in
    the path is read from the automation's URL in the product. Authenticated with a Bearer API token generated at Settings,
    API. This is the only Chatfuel API with live public documentation as of 2026-08-13. No rate-limit headers are returned.
  humanURL: https://help.chatfuel.com/create-contacts-in-chatfuel-via-api-23134b06ecf8800683b6efacab24b68d
  baseURL: https://panel.chatfuel.com/api
  tags:
  - Contacts
  - WhatsApp
  - Bulk Import
  properties:
  - type: Authentication
    url: authentication/catnip-authentication.yml
  - type: RateLimits
    url: rate-limits/catnip-rate-limits.yml
  - type: ErrorCatalog
    url: errors/catnip-problem-types.yml
- name: Chatfuel Broadcasting API
  description: Programmatically send messages and trigger flows/blocks to a specific bot user on Messenger, Instagram, or
    WhatsApp. POST to the send endpoint with the bot's unique chatfuel_token and a flow name, block name, or block id; supports
    message tags for messaging outside the 24-hour window and setting user attributes. Rate limited to 25 requests per second
    per bot. The endpoint is still live and returns structured errors when probed, but its documentation was removed when
    the docs.chatfuel.com developer help centre was retired.
  humanURL: https://help.chatfuel.com
  baseURL: https://api.chatfuel.com
  x-documentation-status: retired
  x-retired-humanURL: https://docs.chatfuel.com/en/articles/790461-broadcasting-api
  x-retired-humanURL-status: 404
  x-retired-humanURL-probed: '2026-08-13'
  tags:
  - Messaging
  - Broadcast
  - Chatbots
  properties:
  - type: Authentication
    url: authentication/catnip-authentication.yml
  - type: RateLimits
    url: rate-limits/catnip-rate-limits.yml
  - type: ErrorCatalog
    url: errors/catnip-problem-types.yml
- name: Chatfuel Dashboard API
  description: Manage Chatfuel bots and their Facebook page bindings. Create empty bots, clone content between bots, generate
    role-scoped invite links (ADMIN, EDITOR, MARKETER, OPERATOR, VIEWER), and bind/unbind bots to Facebook pages. Authenticated
    with a Bearer Dashboard API Token generated from the account profile. Documented as primarily for internal use and subject
    to change; the documenting page has since been removed, though the endpoint still answers with a 401 envelope when probed.
  humanURL: https://help.chatfuel.com
  baseURL: https://dashboard.chatfuel.com/api
  x-documentation-status: retired
  x-retired-humanURL: https://docs.chatfuel.com/en/articles/2706667-dashboard-api
  x-retired-humanURL-status: 404
  x-retired-humanURL-probed: '2026-08-13'
  tags:
  - Bot Management
  - Administration
  properties:
  - type: Authentication
    url: authentication/catnip-authentication.yml
  - type: ErrorCatalog
    url: errors/catnip-problem-types.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://chatfuel.com
- type: DeveloperPortal
  url: https://academy.chatfuel.com
- type: Documentation
  url: https://help.chatfuel.com
- type: APIReference
  url: https://help.chatfuel.com/create-contacts-in-chatfuel-via-api-23134b06ecf8800683b6efacab24b68d
- type: GettingStarted
  url: https://academy.chatfuel.com/docs
- type: Support
  url: https://help.chatfuel.com
- type: Blog
  url: https://chatfuel.com/blog
- type: StatusPage
  url: https://status.chatfuel.com
- type: ChangeLog
  url: https://academy.chatfuel.com/changelog
- type: ChangeLog
  url: changelog/catnip-changelog.yml
- type: Pricing
  url: https://chatfuel.com/pricing
- type: SignUp
  url: https://panel.chatfuel.com/sign-in
- type: TermsOfService
  url: https://chatfuel.com/files/TermsOfUse.pdf
- type: PrivacyPolicy
  url: https://chatfuel.com/privacy-policy.html
- type: Compliance
  url: https://chatfuel.com/gdpr
- type: Authentication
  url: authentication/catnip-authentication.yml
- type: Conventions
  url: conventions/catnip-conventions.yml
- type: RateLimits
  url: rate-limits/catnip-rate-limits.yml
- type: Packages
  url: packages/catnip-packages.yml
- type: DomainSecurity
  url: security/catnip-domain-security.yml
- type: Plans
  url: plans/catnip-plans-pricing.yml
- type: ErrorCatalog
  url: errors/catnip-problem-types.yml
- type: Lifecycle
  url: lifecycle/catnip-lifecycle.yml
- type: Conformance
  url: conformance/catnip-conformance.yml
- type: Components
  url: components/catnip-components.yml
- type: MCPServer
  url: mcp/catnip-mcp.yml
- type: LLMsTxt
  url: llms/catnip-llms.txt
x-enrichment:
  date: '2026-08-13'
  status: enriched
  artifacts_added: 11
  pass: local-v1