Whatixo.Docs Français Open Whatixo
Docs / Whatixo API

Status and session

Publish a status

POSThttps://api.whatixo.com/api/whatsapp/status/publish

Publishes a status (“story”) visible for 24 hours. It is shared with your number and the contacts in your Whatixo CRM.

FieldTypeDescription
deviceIdrequiredstringNumber that publishes.
textoptional*stringStatus text, or the media caption.
mediaUrloptional*stringImage or video (.mp4) over https://.
backgroundColoroptionalstringBackground color of a text status, e.g. #00D084 (default).
fontoptionalintegerText status font (1 to 5).

* text or mediaUrl is required.

curl -X POST https://api.whatixo.com/api/whatsapp/status/publish \
  -H "x-api-key: $WHATIXO_API_KEY" -H "Content-Type: application/json" \
  -d '{"deviceId":"8f2c1a7e-4b9d-4e21-9a6f-3c5d7e1b2a90","text":"🔥 New arrivals this morning!","backgroundColor":"#0f172a","font":2}'
Response 200JSON
{ "success": true, "message": "Statut texte publié avec succès !", "audienceCount": 841 }

audienceCount: number of status recipients (you + your contacts).

Only contacts who have saved your number in their phone see your statuses: that’s a WhatsApp rule.

Disconnect a number

POSThttps://api.whatixo.com/api/whatsapp/accounts/logout

Closes the number’s WhatsApp session (same as removing the linked device from the phone). You’ll need to scan a QR code again in the app to reconnect it.

RequestJSON
{ "deviceId": "8f2c1a7e-4b9d-4e21-9a6f-3c5d7e1b2a90" }
Response 200JSON
{ "success": true, "message": "Appareil déconnecté avec succès." }

404 if the number is unknown or already disconnected.

This can’t be undone from the API: keep it for specific cases (an employee leaving, a lost phone).