Documentation

Getting started

Five steps from zero to your first WhatsApp message sent via API.

1. Create an account

Go to /signup and pick a plan. To try things out, choose Free — 50 messages/month, lifetime, no credit card.

2. Sign in to the admin

Right after signing up you land in your portal at textmeflow.eu/admin/portal. There you'll find your API key, your usage and the button to link your WhatsApp. Coming back later? Via /login we email you a sign-in link — no password needed.

3. Link your phone

On your phone, open WhatsApp → Settings → Linked devices → Link a device. Scan the QR code in the admin, or choose Link with phone number instead in the admin and type the 8-character code in WhatsApp. Your session stays signed in as long as your phone comes online every now and then.

4. Send your first message

# Vervang $TMF_API_KEY door de key uit je admin
curl -X POST https://api.textmeflow.eu/v1/messages \
  -H "Authorization: Bearer $TMF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+32479123456",
    "text": "Hallo van TextMeFlow"
  }'

5. Webhook for replies

Want to receive inbound messages? Configure a webhook URL under /admin/webhook. TextMeFlow POSTs every inbound message as JSON, signed with HMAC-SHA256 in the X-TextMeFlow-Signature header. The payload is 1-to-1 compatible with TextMeBot — existing integrations work without changes.

# Voorbeeld payload (TextMeBot-compatibel)
{
  "type": "text",
  "from": "32479123456",
  "from_name": "Jan Janssens",
  "to": "32499123456",
  "file": "null",
  "message": "Bedankt!"
}

Full documentation + verify snippets in PHP/Node/Python: /docs/webhooks.

Next step

Read the anti-spam best practices before you go to production — it keeps your number safe.