Skip to main content
POST
Mark Message as Read
Mark a message the customer sent as read (blue ticks) without showing “typing…”. Use it to acknowledge a message the moment your code accepts it, then send a typing indicator only when you start on the reply. WhatsApp also marks every earlier message in that chat as read. Nothing is stored in the chat.

Basic Usage

Without a message_id, FlowIQ uses the customer’s latest WhatsApp message. To mark a specific message, pass its id (the whatsapp_message_id of the message_received webhook):

Read or typing?

A typing indicator always marks the message as read too, so there is no typing without read. A read receipt cannot be undone.

Request Body

The API key needs the send permission.

Response

Success (200)

Errors


Integration Example

Acknowledge on arrival, show typing only while the reply is being written:

Authorizations

Authorization
string
header
required

Your FlowIQ API key (from Settings → Profile → API Keys), sent as a bearer token. Format: Bearer fiq_YOUR_API_KEY

Body

application/json
phone_number
string
required

The customer's WhatsApp number with country code. The contact must exist in FlowIQ.

Example:

"+27123456789"

message_type
enum<string>
required

Must be "read"

Available options:
read
Example:

"read"

read
object

Optional.

Response

Message marked as read

success
boolean
Example:

true

message
string
Example:

"Message from 27123456789 marked as read"

data
object