---
canonical_url: "https://docs.composio.dev/toolkits/sentfromai"
markdown_url: "https://docs.composio.dev/toolkits/sentfromai.md"
product: "platform"
version: null
last_updated: null
---

# SentFromAI

SentFromAI provides email infrastructure for AI agents, including inboxes, messages, threads, drafts, webhooks, labels, and domains.

- **Category:** email
- **Auth:** NO_AUTH, API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 40
- **Triggers:** 0
- **Slug:** `SENTFROMAI`
- **Version:** 00000000_00

## Tools

### Assign Label

**Slug:** `SENTFROMAI_ASSIGN_LABEL`

Assign an existing label to one message.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `label_id` | string | Yes | ID of the label to assign. |
| `message_id` | string | Yes | ID of the message that should receive the label. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Assign Label Batch

**Slug:** `SENTFROMAI_ASSIGN_LABEL_BATCH`

Assign one existing label to 1-25 unique message IDs with one sequential SentFromAI request per ID. Duplicate IDs are rejected before any request. The operation is non-atomic and preserves caller order. Successful responses and transport-unknown outcomes are returned in order because successful entries are not rolled back. A missing provider response is unknown: verify that message's label state before retrying and never retry based on an assumed failure. Every non-200 provider response stops the batch with a typed error containing the complete ordered processed prefix and current rejection; no remaining requests run. A Keyring proxy failure also stops immediately because the current provider outcome may be unknown and must be checked before retrying.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `label_id` | string | Yes | ID of the existing label to assign or unassign. |
| `message_ids` | array | Yes | Ordered unique IDs of 1-25 messages. Each ID causes one sequential provider request. The bound caps agent-triggered mutations and request latency. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Agent Signup

**Slug:** `SENTFROMAI_CREATE_AGENT_SIGNUP`

Create an irreversible SentFromAI tenant, receive-only inbox, API key, and private claim URL when staged agent signup is enabled. The provider documents this endpoint as unauthenticated, so no prior SentFromAI credential is required. Save the idempotency secret and exact body before calling, then preserve all returned credentials privately.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Optional workspace display name. Whitespace is trimmed and control characters are rejected; omit to use the provider default. |
| `local_part` | string | No | Optional inbox name before @. Use 1-64 letters, digits, dots, underscores, or hyphens; begin and end with a letter or digit and do not use consecutive dots. The provider trims and lowercases it. Omit to allocate a name. |
| `idempotency_key` | string | Yes | Credential-like high-entropy secret sent as Idempotency-Key. Generate at least 32 random bytes as 32-128 URL-safe characters, save it privately with the exact body before the first request, and reuse both for retries. Never log or share this secret broadly. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Delivery Rule

**Slug:** `SENTFROMAI_CREATE_DELIVERY_RULE`

Create an inbound or outbound allow/block rule for addresses matching a pattern.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `kind` | string ("allow" | "block") | Yes | Whether matching addresses are explicitly allowed or blocked. |
| `pattern` | string | Yes | Email address or provider-supported address pattern to match. |
| `direction` | string ("inbound" | "outbound" | "both") | No | Message direction to which the rule applies. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Domain

**Slug:** `SENTFROMAI_CREATE_DOMAIN`

Add a custom sending domain and return the DNS records required to configure it. This paid capability requires the SentFromAI Pro plan with the customDomains entitlement; use Get Account Status to confirm that entitlement before calling this action. Free accounts receive a plan-upgrade error.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hostname` | string | Yes | Fully qualified domain name to add for sending. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Draft

**Slug:** `SENTFROMAI_CREATE_DRAFT`

Create an editable email draft for a new message or reply. Optionally schedule future irreversible delivery with scheduled_at; confirm recipients and content before scheduling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | array | No | Recipient email addresses for the draft. |
| `html` | string | No | HTML draft body. |
| `text` | string | No | Plain-text draft body. |
| `subject` | string | No | Email subject line. |
| `inbox_id` | string | Yes | ID of the inbox that owns and sends the draft. |
| `scheduled_at` | string | No | Optional ISO 8601 delivery time. Supplying it schedules future email delivery, which is irreversible once sent; confirm recipients and content before setting it. |
| `reply_to_message_id` | string | No | Message ID when creating a draft reply. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Inbox

**Slug:** `SENTFROMAI_CREATE_INBOX`

Create an email inbox in the connected workspace, using the system domain unless a domain ID is supplied.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain_id` | string | No | Optional existing domain ID; omit to use the workspace's system domain. |
| `local_part` | string | Yes | Mailbox name before the @ sign for the new inbox. |
| `display_name` | string | No | Optional human-readable name for the inbox. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Label

**Slug:** `SENTFROMAI_CREATE_LABEL`

Create a reusable message label with an optional display color.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the new message label. |
| `color` | string | No | Optional provider-supported display color for the label. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Subdomain

**Slug:** `SENTFROMAI_CREATE_SUBDOMAIN`

Provision a dedicated sending subdomain and return the DNS records required to configure it. Requires the Scale plan with custom-domain capability.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `label` | string | Yes | Dedicated subdomain label containing only lowercase letters, digits, and hyphens. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Webhook

**Slug:** `SENTFROMAI_CREATE_WEBHOOK`

Register a public HTTPS callback URL to receive selected SentFromAI events.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Public HTTPS callback URL that will receive private webhook deliveries. |
| `events` | array | No | Optional documented event names to subscribe to; omit to use the provider's default event set. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Delivery Rule

**Slug:** `SENTFROMAI_DELETE_DELIVERY_RULE`

Delete one allow/block delivery rule by ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rule_id` | string | Yes | Opaque ID of the allow/block delivery rule to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Domain

**Slug:** `SENTFROMAI_DELETE_DOMAIN`

Delete one sending domain by UUID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain_id` | string | Yes | UUID of the sending domain to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Draft

**Slug:** `SENTFROMAI_DELETE_DRAFT`

Delete one existing email draft by ID without sending it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `draft_id` | string | Yes | Opaque ID of the email draft to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Inbox

**Slug:** `SENTFROMAI_DELETE_INBOX`

Delete one inbox by ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `inbox_id` | string | Yes | Opaque ID of the inbox to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Label

**Slug:** `SENTFROMAI_DELETE_LABEL`

Delete one reusable message label by ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `label_id` | string | Yes | Opaque ID of the reusable message label to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Webhook

**Slug:** `SENTFROMAI_DELETE_WEBHOOK`

Delete one webhook subscription by ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | Opaque ID of the webhook subscription to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Forward Message

**Slug:** `SENTFROMAI_FORWARD_MESSAGE`

Immediately and irreversibly forward a SentFromAI message to new recipients. The forward creates a new thread. Confirm recipients before calling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | array | Yes | Recipient email addresses for the forwarded message. |
| `text` | string | No | Optional note to add to the forwarded message. |
| `client_id` | string | No | Caller-generated idempotency key for safe retries. Reuse it only with identical forward content, and never switch to a new key after an uncertain send. |
| `message_id` | string | Yes | ID of the message to forward. |
| `from_inbox_id` | string | No | Inbox ID to send from when SentFromAI cannot infer one from the source message. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Status

**Slug:** `SENTFROMAI_GET_ACCOUNT_STATUS`

Return the connected account's onboarding state, capabilities, limits, usage, inboxes, and sending status for workflow preflight.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Attachment

**Slug:** `SENTFROMAI_GET_ATTACHMENT`

Retrieve one message attachment. Current first-party sources document either attachment content or a fresh short-lived signed download URL; both response shapes are accepted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `attachment_id` | string | Yes | ID of the attachment to retrieve from a message or thread response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Domain

**Slug:** `SENTFROMAI_GET_DOMAIN`

Get one sending domain with its verification state and required DNS records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain_id` | string | Yes | UUID of the domain to retrieve, typically from List Domains or a domain creation response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Draft

**Slug:** `SENTFROMAI_GET_DRAFT`

Get one draft's documented identity, inbox, subject, status, and schedule. Optional compatibility fields are returned when the provider includes them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `draft_id` | string | Yes | ID of the draft to retrieve, typically from List Drafts or Create Draft. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Message

**Slug:** `SENTFROMAI_GET_MESSAGE`

Get one message's body, participants, labels, delivery state, thread ID, and attachment metadata by message ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message_id` | string | Yes | ID of the message to retrieve, typically from Search Messages or Get Thread. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Thread

**Slug:** `SENTFROMAI_GET_THREAD`

Get one email thread with its embedded messages in conversation order.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `thread_id` | string | Yes | ID of the thread to retrieve, typically from List Threads or a send result. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Delivery Rules

**Slug:** `SENTFROMAI_LIST_DELIVERY_RULES`

List inbound and outbound allow/block rules configured in the connected workspace.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Domains

**Slug:** `SENTFROMAI_LIST_DOMAINS`

List system and custom sending domains with their verification and mail configuration status.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Drafts

**Slug:** `SENTFROMAI_LIST_DRAFTS`

List compact summaries of all current email drafts in the connected workspace.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Inboxes

**Slug:** `SENTFROMAI_LIST_INBOXES`

List the email inboxes in the connected workspace and return the IDs and addresses needed by message and draft actions.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Labels

**Slug:** `SENTFROMAI_LIST_LABELS`

List reusable message labels configured in the connected workspace.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Threads

**Slug:** `SENTFROMAI_LIST_THREADS`

List compact email thread summaries, optionally restricted to one inbox.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum thread summaries to return. The API provides no continuation token. |
| `inbox_id` | string | No | Optional inbox ID whose threads should be returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Webhooks

**Slug:** `SENTFROMAI_LIST_WEBHOOKS`

List webhook subscriptions configured in the connected workspace.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Refresh Account Claim Link

**Slug:** `SENTFROMAI_REFRESH_ACCOUNT_CLAIM_LINK`

Create a new private claim link for the connected account. This applies only while the account is active and unclaimed, requires its existing API key, and does not rotate that key or extend account lifetime. Keep the returned URL private and give it only to the actual operator in an existing trusted chat.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Reply to Message

**Slug:** `SENTFROMAI_REPLY_TO_MESSAGE`

Immediately and irreversibly send a reply in the source message's thread, optionally including all original participants. Confirm the reply content and participants before calling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `html` | string | No | HTML reply body. Provide html, text, or both. |
| `text` | string | No | Plain-text reply body. Provide text, html, or both. |
| `client_id` | string | No | Caller-generated idempotency key for safe retries. Reuse it only with identical reply content, and never switch to a new key after an uncertain send. |
| `reply_all` | boolean | No | Whether to include all original participants instead of replying only to the sender. |
| `message_id` | string | Yes | ID of the message to reply to. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Messages

**Slug:** `SENTFROMAI_SEARCH_MESSAGES`

Search messages by text, or list recent messages when query is omitted, optionally limited to one inbox.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("keyword" | "semantic" | "hybrid") | No | Search strategy when query is present. Semantic and hybrid availability depends on the connected account's entitlements and may fall back to keyword. |
| `limit` | integer | No | Maximum messages to return. The API provides no continuation token. |
| `query` | string | No | Text to search for; omit to return the most recent messages. |
| `inbox_id` | string | No | Inbox ID to restrict the search or recent-message list to. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Draft

**Slug:** `SENTFROMAI_SEND_DRAFT`

Immediately and irreversibly send an existing SentFromAI draft that is in a sendable state. Confirm its recipients and content before calling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `draft_id` | string | Yes | ID of the completed draft to send. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Message

**Slug:** `SENTFROMAI_SEND_MESSAGE`

Immediately and irreversibly send a new email from a SentFromAI inbox. Supports CC, BCC, plain text, HTML, threading headers, idempotency, and base64-encoded attachments. Confirm recipients and content before calling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cc` | array | No | Optional CC recipient email addresses. |
| `to` | array | Yes | Primary recipient email addresses. At least one address is required. |
| `bcc` | array | No | Optional BCC recipient email addresses. |
| `html` | string | No | HTML body. Provide html, text, or both. |
| `text` | string | No | Plain-text body. Provide text, html, or both. |
| `subject` | string | Yes | Email subject line. |
| `inbox_id` | string | Yes | ID of the inbox that sends the message. |
| `client_id` | string | No | Caller-generated idempotency key for safe retries. Reuse it only with identical message content, and never switch to a new key after an uncertain send. |
| `references` | array | No | RFC message IDs used for email threading. |
| `attachments` | array | No | Attachments to send. The total attachment payload should remain under the provider's approximately 7 MB email limit. |
| `in_reply_to` | string | No | RFC message ID used to thread this manually composed message. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set DMARC Policy

**Slug:** `SENTFROMAI_SET_DMARC_POLICY`

Set a domain's DMARC enforcement policy and return the DNS record that must be published.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `policy` | string ("none" | "quarantine" | "reject") | Yes | DMARC handling policy to publish and enforce for failed authentication. |
| `domain_id` | string | Yes | UUID of the domain whose DMARC policy should change. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unassign Label

**Slug:** `SENTFROMAI_UNASSIGN_LABEL`

Remove an existing label assignment from one message without deleting the label.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `label_id` | string | Yes | ID of the label to remove from the message. |
| `message_id` | string | Yes | ID of the message whose label assignment should be removed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unassign Label Batch

**Slug:** `SENTFROMAI_UNASSIGN_LABEL_BATCH`

Remove one existing label from 1-25 unique message IDs with one sequential SentFromAI request per ID. Duplicate IDs are rejected before any request. The operation is non-atomic and preserves caller order. Successful responses and transport-unknown outcomes are returned in order because successful entries are not rolled back. A missing provider response is unknown: verify that message's label state before retrying and never retry based on an assumed failure. Every non-200 provider response stops the batch with a typed error containing the complete ordered processed prefix and current rejection; no remaining requests run. A Keyring proxy failure also stops immediately because the current provider outcome may be unknown and must be checked before retrying.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `label_id` | string | Yes | ID of the existing label to assign or unassign. |
| `message_ids` | array | Yes | Ordered unique IDs of 1-25 messages. Each ID causes one sequential provider request. The bound caps agent-triggered mutations and request latency. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Draft

**Slug:** `SENTFROMAI_UPDATE_DRAFT`

Replace the editable fields of an existing email draft. Optionally schedule future irreversible delivery with scheduled_at; confirm recipients and content before scheduling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | array | No | Updated recipient email addresses. |
| `html` | string | No | Updated HTML body. |
| `text` | string | No | Updated plain-text body. |
| `subject` | string | No | Updated email subject line. |
| `draft_id` | string | Yes | ID of the draft to update. |
| `inbox_id` | string | Yes | ID of the inbox that owns the draft; required by the current API contract even when unchanged. |
| `scheduled_at` | string | No | Updated ISO 8601 delivery time. Supplying it schedules future email delivery, which is irreversible once sent; confirm recipients and content before setting it. |
| `reply_to_message_id` | string | No | Updated source message ID when this draft is a reply. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Domain

**Slug:** `SENTFROMAI_VERIFY_DOMAIN`

Re-check a domain's published DNS records and return its current verification status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain_id` | string | Yes | UUID of the domain whose DNS verification should be re-checked. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
