Wauto API Documentation

Complete guide to integrate WhatsApp Automation API

Installation

Before using the API, you need to install the Chrome Extension to connect WhatsApp Web with the API server.

Download Extension

Download Chrome Extension:

Download wauto-ext.zip

Installation Steps

  1. Extract the zip file you downloaded
  2. Open Chrome and type chrome://extensions/ in the address bar
  3. Enable Developer mode (toggle in the top right corner)
  4. Click Load unpacked
  5. Select the wauto-ext folder that was extracted
  6. Click the extension icon in Chrome toolbar
  7. Enter your API key from the dashboard (go to API Keys page to generate one)
  8. Click Save
  9. Open web.whatsapp.com
  10. Extension will automatically connect!

Tips:

Make sure the API server is running before opening WhatsApp Web. Use the /status endpoint to verify the connection.

Authentication

All API endpoints require an API key passed in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key from the Dashboard after signing up.

Status

GET /status

Check if the extension is connected. No authentication required.

curl https://wauto.mfrcode.com/status

Response

{ "ok": true, "connected": true, "clients": [{ "id": "ext_1710...", "connectedAt": "2026-03-15T..." }] }

Health Check

GET /health

Check if the WhatsApp bridge is ready.

curl https://wauto.mfrcode.com/health \ -H "Authorization: Bearer YOUR_API_KEY"

Send Text Message

POST /send-text

Parameter Type Required Description
number string Yes Phone number with country code (e.g. 5521999999999)
text string Yes Message text to send
curl -X POST https://wauto.mfrcode.com/send-text \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "number": "5521999999999", "text": "Hello from Wauto!" }'

Send Audio

POST /send-audio

Parameter Type Required Description
number string Yes Phone number
audioBase64 string Yes Base64-encoded audio
audioMime string No MIME type (default: audio/ogg)
audioName string No Filename

POST /send-audio-url — Same but provide audioUrl instead of base64.

Send Image

POST /send-image

Parameter Type Required Description
number string Yes Phone number
imageBase64 string Yes Base64-encoded image
imageMime string No MIME type (default: image/jpeg)
caption string No Image caption

POST /send-image-url — Same but provide imageUrl instead of base64.

Voice Call

POST /call

Make a voice call and play custom audio. Requires Pro plan.

Parameter Type Required Description
number string Yes Phone number
audioBase64 string Yes Base64-encoded audio to play
audioMime string No MIME type (default: audio/mpeg)
timeout number No Call timeout in seconds
curl -X POST https://wauto.mfrcode.com/call \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "number": "5521999999999", "audioBase64": "BASE64_AUDIO_DATA", "audioMime": "audio/mpeg", "timeout": 30 }'

POST /call-url — Same but provide audioUrl instead of base64.

Hangup

POST /hangup

Hang up the current call.

curl -X POST https://wauto.mfrcode.com/hangup \ -H "Authorization: Bearer YOUR_API_KEY"

Create Schedule

POST /schedule

Schedule a message or call for future delivery. Requires Pro plan.

Parameter Type Required Description
action string Yes sendText, sendAudio, sendImage, or call
params object Yes Action parameters (number, text, etc.)
scheduledAt string Yes ISO 8601 datetime
repeat object No { count, intervalMs } for recurring
curl -X POST https://wauto.mfrcode.com/schedule \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "action": "sendText", "params": { "number": "5521999999999", "text": "Scheduled message!" }, "scheduledAt": "2026-03-16T09:00:00Z" }'

List Schedules

GET /schedules

List all scheduled jobs. Optional filter: ?status=pending

GET /schedule/:id — Get one schedule

PUT /schedule/:id — Update a pending schedule

DELETE /schedule/:id — Cancel a schedule

DELETE /schedules/clear — Remove completed/failed/cancelled

Error Codes

HTTP Code Error Description
401 Invalid API key API key not found or invalid
402 Insufficient credits Not enough credits for this action
403 Plan restriction Action not available on your plan
429 Rate limited Too many requests per minute
500 Extension error Error forwarding to WhatsApp
503 Extension offline No extension connected

Credit Costs

Action Credits
Send Text 1
Send Audio 2
Send Image 2
Voice Call 5
Health Check 0
Hangup 0