Chatofy Developer Portal & WhatsApp API Documentation
Build & Automate with Chatofy API
Access our OpenAPI 3.0 specification, CLI tools, rate-limited REST endpoints, and structured JSON responses designed for human engineers and AI agents.
API Key Authentication
All requests to Chatofy developer endpoints require an active Bearer API token generated in your dashboard under Settings → API & Webhooks.
# Example HTTP Header
Authorization: Bearer ctf_live_98a72b1092e482fa1029
Rate Limit Headers & Throttling
To allow AI agents and scripts to self-throttle in real time, Chatofy returns RFC-standard rate limit response headers on every API response.
RateLimit-Limit: 120
Maximum API calls allowed per 60-second window.
RateLimit-Remaining: 118
Remaining calls in the current active window.
RateLimit-Reset: 45
Time in seconds remaining until the quota resets.
Retry-After: 60
Returned on HTTP 429 status code indicating backoff duration.
Structured JSON Error Schema
Chatofy APIs never return HTML error pages. Every error is returned in structured JSON format with uppercase error codes, explanations, and resolution hints for AI agents.
{
"success": false,
"error": {
"code": "INVALID_PAYLOAD",
"message": "Name and Email are required fields.",
"hint": "Ensure request body contains JSON with 'name' and 'email' fields.",
"timestamp": "2026-09-26T12:00:00+05:30"
}
}Official Chatofy CLI (\`npx @chatofy/cli\`)
Script interactions with Chatofy directly from your terminal or AI agent workflows without building custom HTTP integrations.
# Check status and system health
$ npx @chatofy/cli status
# Send a test WhatsApp message
$ npx @chatofy/cli message send --to +917838343515 --text "Hello from Chatofy CLI"
# View OpenAPI spec overview
$ npx @chatofy/cli openapi
Public & Developer Endpoints
| Method | Endpoint | Operation ID | Description |
|---|---|---|---|
| POST | /api/contact | submitContactInquiry | Submit contact or enterprise sales inquiry. |
| POST | /api/partners | applyPartnerProgram | Apply for agency or reseller partner program. |
| POST | /api/v1/messages/send | sendWhatsAppMessage | Send WhatsApp message or Meta template. |
| GET | /api/v1/contacts | getContactsList | Retrieve contacts list and custom tags. |
Start with a 7-day
free trial of Pro.
No credit card. No approval wait. Get your WhatsApp Business API live in minutes.