Skip to main content
Send emails and manage drafts. Requires Connect access.
Subjects and bodies are plain text. Do not include HTML tags or a sign-off line (signatures are appended automatically). Personalize with square-bracket merge tags from seamless://templates/variables, such as [first_name] and [company].

Email accounts

Email send and drafts

send_email

integer | string
required
Saved contact ID from get_my_contacts (not a search result ID).
string
required
Sender email address from a connected account (list_email_accounts or seamless://email-accounts).
string
required
Recipient email address.
Sends to recipients on the public internet. Require explicit user approval in agent workflows.

Example

send_bulk_email

Resolves the audience first and rejects the request if more than 500 contacts match — the send is not truncated. Opted-out and unsubscribed contacts are skipped. Returns jobId plus matched, queued, and skipped counts.
string
required
Sender email address from a connected account.
object
required
Must include at least one of lists, contactIds, campaignIds, or a text query (queryText, queryTextName, queryTextCompany, queryTextDomain, queryTextTitle, queryTextLocation). An empty filter set is rejected so the whole book is never mailed.
string
Required if no templateId. Supports merge tags from seamless://templates/variables.
string
Required if no templateId.
integer
Send an existing template instead of subject and body.
string
A retry with the same key returns the original job. Reusing a key with a different audience or message is rejected.
Sends to many recipients at once. Require explicit user approval and show the audience size before calling.

Example