Skip to main content
inputCreateConversationInput

Fields

assetIds
[ID!]

IDs of previously uploaded assets (images, files) to attach to the opening message

clientMutationId
String

A unique identifier for the client performing the mutation.

embeddedLinkId
ID

ID of an embedded link (link preview) to attach to the opening message

preserveParagraphSpacing
Boolean

When true, convert bare newlines to line breaks, matching the legacy direct-message action. Paragraph spacing is preserved for every message regardless. Defaults to false.

recipientIds
[ID!]!
required

GlobalIDs of the recipients (excluding yourself)

reportSkipsAsOutcomes
Boolean

When true, the send-time conditions a direct-message automation gracefully skips (self-message, private chat disabled for the Network, sender, or recipient, a Limited Member recipient, or a non-Host sender) return a coded skipped outcome instead of raising or erroring. Defaults to false.

text
String!
required

Message text (HTML is sanitized server-side)

title
String

Optional name for a newly created group conversation