Type Alias ResolvedRecipient

A Plot contact pre-resolved to its platform account ID, ready for use in a messaging dispatch — the outbound recipient of a composed item (CreateLinkDraft.recipients) or of a reply (Note.recipients).

Populated by the runtime for link types whose compose.targets is "contacts" or "addresses". The connector should address the recipient with externalAccountId directly (e.g. Slack user ID, LinkedIn URN, Gmail email address) without performing its own contact lookup, and MUST honor role so "cc"/"bcc" recipients are placed in the right headers.

The runtime already excludes the acting user's own contacts (all of their linked identities, not just the connected mailbox), so a connector must not re-add itself and can trust this list as the complete recipient set.

type ResolvedRecipient = {
    id: Uuid;
    name: string | null;
    externalAccountId: string;
    role: string | null;
}

Index

Properties

id name externalAccountId role

Properties

id

id: Uuid

Plot contact UUID

name

name: string | null

Display name, or null if not set

externalAccountId

externalAccountId: string

Platform-specific account identifier pre-resolved at dispatch time (e.g. Slack U…, LinkedIn URN, Gmail email address)

role

role: string | null

The contact's role on the originating thread, resolved from thread.contact_meta against the link type's contactRoles (e.g. "to" / "cc" / "bcc" for Gmail). null when the contact had no explicit role entry — connectors should treat null as the link type's default role (the contactRoles entry marked default: true).

Connectors that distinguish roles MUST honor this when addressing the recipient — e.g. Gmail must place "cc"/"bcc" recipients in the Cc/Bcc headers, never the To header, so BCC recipients are not exposed to the other recipients. Connectors that don't distinguish roles (Slack, Linear) can ignore it.

Type Alias ResolvedRecipient

Index

Properties

Properties

id

name

externalAccountId

role

Settings

On This Page