Order Messages

Send order message

POST/api/v1/orders/:id/messages

Sends a message on the order's chat thread — only while the order is actively out for delivery.

Requires Authorization

Chat message — 20 per minute

Path parameters

idstringrequired

Order ID.

Body parameters

bodystringrequired

Up to 1000 characters.

Possible errors

409

CONFLICT

La messagerie n'est disponible que pendant la livraison.

Notes

Messaging is only open while the order is RIDER_ASSIGNED, PICKED_UP, or ON_THE_WAY.

Request

curl --request POST \
  --url https://api.swiftgoma.com/api/v1/orders/:id/messages \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "body": "<body>"
}'

201Example response

{
  "success": true,
  "data": {
    "id": "msg_1a2b3c",
    "orderId": "ord_5e6f7a",
    "senderId": "3f2a1c9e",
    "body": "Je suis devant la porte bleue, merci.",
    "isRead": false,
    "createdAt": "2026-02-15T10:20:00.000Z"
  }
}