​
Overview

A Message is one inbound or outbound message in a Thread. Messages are returned by GET /v1/threads/{id}/messages and delivered in webhook events.

​
Properties

​
thread_id
string
ID of the thread this message belongs to.
​
guid
string
Globally unique message identifier. Stable across reads and webhook deliveries — use it to deduplicate.
​
rowid
number
Monotonically increasing message sequence number. Used as the pagination cursor (before parameter) when reading history.
​
text
string
The message body.
​
from_me
boolean
true if the message was sent from your number, false for inbound messages.
​
service
string | null
The service the message was carried over: iMessage or SMS.
​
address
string
The other party’s address (canonical phone number or iMessage email handle).
​
unix_ms
number
When the message was sent or received, in milliseconds since the Unix epoch.

​
Webhook-only properties

Messages delivered in webhook events additionally include delivery-state flags:
​
is_delivered
boolean
Whether the message has been delivered.
​
is_read
boolean
Whether the message has been read.
​
is_sent
boolean
Whether an outbound message has been sent.

​
Example

{
  "thread_id": "0b6f5c1e-8f4a-4f4b-9a2d-3a1c2b3d4e5f",
  "guid": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
  "rowid": 4521,
  "text": "Hey, got your message!",
  "from_me": false,
  "service": "iMessage",
  "address": "+15551234567",
  "unix_ms": 1765432100000
}