Skip to main content
POST
Create a broadcast communication (Mixpeek admin only).

Authorizations

Authorization
string
header
required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing, malformed, unknown, revoked, inactive or expired key returns 401; a key without the permission, scope or plan an operation needs returns 403.

Body

application/json

Keys this body does not declare are ignored, and the response's warnings name them, until 2026-11-02; from 2026-11-02 they are refused with 422 extra_forbidden naming the accepted keys.

Admin-only: a standalone communication not attached to a ticket.

body
string
required
Required string length: 1 - 10000
scope
enum<string> | null
Available options:
global,
organization
organization_id
string | null

Response

Successful Response

message_id
string
required
author_type
enum<string>
required

Who wrote a message — the customer or the Mixpeek team.

Available options:
customer,
mixpeek
body
string
required
ticket_id
string | null
organization_id
string | null
author
SupportActor · object | null

Lightweight snapshot of who created a ticket/message.

attachments
SupportAttachment · object[]
created_at
string<date-time> | null