Skip to main content
POST
Create Message

Authorizations

Authorization
string
header
required

Org API key as Token token=ei_live_...

Headers

Idempotency-Key
string | null

Body

application/json

POST /v1/messages → send an in-app message into a conversation. sender_id must be an accepted org member who is an active participant of the conversation. The message is always inserted as message_type='text', visibility='everyone' (so the existing notify/email/mirror triggers fire normally); system/private message types are not settable via the API.

conversation_id
string
required
sender_id
string
required
content
string
required
Required string length: 1 - 10000
reply_to_id
string | null

Response

Successful Response

One message in a thread. Only visibility='everyone' (non-deleted) messages are exposed by the read endpoints — family-private (student_only/parent_only) messages are never returned.

id
string
required
conversation_id
string | null
sender_id
string | null
content
string | null
message_type
string | null
visibility
string | null
reply_to_id
string | null
created_at
string | null