Common Request Fields

These top-level fields are shared across all Send Direct request types.

Field	Type	Required	Description
phone	string	Yes	Recipient phone number in E.164 format. Example: {phone}
type	string	Yes	Always "send-direct" for all requests in this collection.
text	string	No*	Plain text body. Required for text messages. Max 1024 characters. Mutually exclusive with media.
media	object	No*	Required for interactive, image, video, audio, location, sticker, document, contacts, reaction, flow, and list messages.
ttl_seconds	integer	No	Message time-to-live in seconds. Valid range: 30–43200. Omit for platform default.
enable_acculync	boolean	No	Enables Acculync delivery optimisation. Defaults to false.
extra	string	No	Custom correlation/reference ID for your own tracking.
preview_url	boolean	No	Not supported in Send Direct mode. Include only for completeness testing.
scheduled_time	string	No	Scheduled dispatch timestamp. Format: "YYYY-MM-DD HH:MM:SS". Used by scheduled endpoint only.