Website URL to scrape Brand Kit from

Public or Nitro CDN URL to a logo image (png/jpg/webp/svg) to attach. For a small local logo, call nitro_ingest with kind='image' and image_data. For a larger local logo, call nitro_ingest with upload={kind: 'image', filename, content_type, byte_size, checksum}, PUT bytes to direct_upload.url, then call nitro_ingest with signed_id. Pass the returned media_url or image_url here. Raw signed_id values are not accepted.

Direct Brand Kit field updates

Full brand voice markdown document

Preview changes without persisting

sync (default) or async for URL scraping

Optional dedup key

Asset kind to ingest. V1 supports image only.

Image payload as raw base64 bytes or a full data URL. PNG, JPEG, or WebP only; decoded size must be under 10MB.

Public http/https image URL to ingest into Nitro-hosted storage when permanence is desired. PNG, JPEG, or WebP only; remote file must be under 10MB.

Upload signed_id returned by this tool's upload reservation after PUTing image bytes to direct_upload.url.

Reserve an authorized upload link for a local asset. V1 supports kind=image only. Provide filename, content_type, byte_size, and base64 MD5 checksum; then PUT bytes to the returned direct_upload.url and call this tool again with signed_id.

Original filename for image_data uploads, or an optional filename override for image_url/signed_id sources.

Optional MIME type hint when image_data is raw base64 rather than a data URL.

Segment name (required when preview_only: false)

Array of filter objects. Each filter has:

• name — filter alias from flows.yml (e.g. "contact_email", "contact_first_name", "contact_country", "contact_subscribed_email", "contact_created_at", "contact_tag")
• predicate — Ransack predicate — eq, not_eq, cont, not_cont, start, end, gt, lt, gteq, lteq, present, blank, true, false
• value — filter value (string, number, or boolean). For present/blank/true/false predicates, pass true.

Existing segment ID to update (omit for new segment)

Only preview matching contacts, do not save (default: true). Set to false + provide name to persist.

Optional deduplication key

Array of contact objects (max 100): {email, phone, first_name, last_name, country_code, source, opt_in}

Existing Import record ID for CSV processing

Upload signed_id returned by this tool's upload reservation after PUTing CSV bytes to direct_upload.url.

Reserve an authorized upload link for a local CSV file. Provide filename, content_type, byte_size, and base64 MD5 checksum; then PUT bytes to the returned direct_upload.url and call this tool again with signed_id.

Import resource. Use contacts for contact CSV imports.

Parser name. Use default unless a future schema documents another parser.

Optional import column mapping object.

Import options, e.g. {list_ids: [123]} to add imported contacts to lists.

Preview import without persisting (default: false)

Optional deduplication key

Array of section objects: {id?, type, props, styles?}. Read nitro://schema for full prop specs. Persisted sections receive stable top-level ids for future section_updates targeting.

Section types and key props:

• header — {variant, wordmark_text, logo_url, logo_alt, logo_width, background_color}
• text — {content (HTML string)}
• image — {src, alt, href, width}
• button — {text, href, background_color, text_color, section_background_color, align, border_radius, inner_padding, font_weight, font_family, text_transform}. background_color is the button fill; section_background_color is the surrounding band.
• columns — {columns: [{width, sections: [...]}]} — nested sections inside columns
• product — {name, price, image_url, href, description}
• social — {links: [{platform, url}], align}
• divider — {color, width, padding}
• spacer — {height}
• footer — {company_name, address, unsubscribe_text}

Image-bearing URL props accept public URLs or Nitro CDN media_url/image_url values returned by nitro_ingest. For a local image too large for image_data, call nitro_ingest with upload={kind: 'image', filename, content_type, byte_size, checksum}, PUT bytes to direct_upload.url, then call nitro_ingest with signed_id and use the returned media_url/image_url here. Do not place raw signed_id values in sections.

Small update shortcut for existing sections. Prefer targeting by stable section id from nitro_query/template reads; fall back to 0-based index, or type plus optional 0-based occurrence. Shallow-merges props/styles or uses text_patch for literal copy edits inside a string prop. Does not change section order or type.

Email subject line (recommended under 60 chars)

Template display name

intent returns composition_contract; validate checks a draft without persistence; draft validates and persists.

Email composition contract id returned from composition_mode=intent.

Alias for composition_mode=validate. Does not persist or consume repair attempts.

Renegotiate/validate the draft under a different design mode.

When true with design_mode_override, keeps the same contract but changes the design mode.

Latest user instruction to preserve inside the composition contract.

Host-composed draft metadata from composition_contract: creative_route_id, concrete_anchor, why_this_earns_the_inbox.

Email preheader text shown in inbox preview

Sender name (falls back to account default)

Sender email (falls back to account default)

Reply-to email address

Theme overrides merged on top of brand theme. Keys: brand_color (hex), bg_color (hex), text_color (hex), font_body (string), font_heading (string), logo_url (public URL or nitro_ingest media_url/image_url, not raw signed_id). For a local logo file, call nitro_ingest with upload={kind: 'image', filename, content_type, byte_size, checksum}, PUT bytes, then call nitro_ingest with signed_id and use the returned media_url/image_url. Also supports radius (integer px), spacing_density (compact, normal, spacious).

Template ID for update mode — provide with fields to change

Source template ID for clone mode — creates a copy

Optimistic concurrency — rejects update if template version mismatches

Goal string for host-composed template composition contracts

Validate and preview without persisting

Dedup key — same key returns cached result

Flow name (required for create mode)

create: new flow; replace: rebuild existing flow graph; patch: metadata only

Required for replace/patch modes

Goal string for host-composed flow composition contracts

intent returns composition_contract; validate checks a draft without persistence; draft validates and persists.

Email composition contract id returned from composition_mode=intent.

Alias for composition_mode=validate. Does not persist or consume repair attempts.

Renegotiate/validate the draft under a different design mode.

When true with design_mode_override, keeps the same contract but changes the design mode.

Latest user instruction to preserve inside the composition contract.

Host-composed draft metadata from composition_contract: creative_route_id, concrete_anchor, why_this_earns_the_inbox.

Ordered array of flow steps. Required props per type:

• email — subject (required), design ({sections, theme}) or body, preheader, from_name, from_email, reply_to, bcc (string, optional BCC email address). Theme may include radius and spacing_density.
• sms — body (required)
• wait — duration (integer, seconds — e.g. 86400 = 1 day)
• split — filters (required, [{name, predicate, value}]), yes (steps array), no (steps array). Nested splits are allowed.
• emit_event — event_name (required), event_data (object), forward_event_data (boolean)
• webhook — url (required), method (POST or PUT, default POST), headers (object), body (template string with merge tags)
• subscribe — channel (phone, email, or all — default phone). Subscribes the contact.
• unsubscribe — channel (phone, email, or all — default phone). Unsubscribes the contact.

Preview graph without persisting

Deduplication key for retry safety

Required for replace mode

Campaign name

create: new campaign; patch: update provided fields on an existing draft campaign; replace: replace existing draft content/audience/schedule and requires confirm: true. Replace clears omitted audience/schedule. Patch/replace cannot change channel.

Required for patch/replace modes

Auto-detected as 'email' when sections or template_id provided. Set explicitly to 'sms' for SMS campaigns. Immutable after campaign creation.

Goal string for host-composed campaign composition contracts

intent returns composition_contract; validate checks a draft without persistence; draft validates and persists.

Email composition contract id returned from composition_mode=intent.

Alias for composition_mode=validate. Does not persist or consume repair attempts.

Renegotiate/validate the draft under a different design mode.

When true with design_mode_override, keeps the same contract but changes the design mode.

Latest user instruction to preserve inside the composition contract.

Host-composed draft metadata from composition_contract: creative_route_id, concrete_anchor, why_this_earns_the_inbox.

Email subject line (email campaigns)

Email preheader (email campaigns)

Sender name override

Sender email override

Reply-to email override

SMS body text (sms campaigns) or email plain text

Email design sections array — same format as nitro_manage_template. Requires subject. Image-bearing URL props accept public URLs or Nitro CDN media_url/image_url values returned by nitro_ingest. For a local image too large for image_data, call nitro_ingest with upload={kind: 'image', filename, content_type, byte_size, checksum}, PUT bytes to direct_upload.url, then call nitro_ingest with signed_id and use the returned media_url/image_url here. Do not place raw signed_id values in sections.

Email theme overrides merged on brand theme: {brand_color, bg_color, text_color, font_body, font_heading, logo_url, radius, spacing_density}. logo_url must be a public URL or nitro_ingest media_url/image_url, not a raw signed_id. For a local logo file, call nitro_ingest with upload={kind: 'image', filename, content_type, byte_size, checksum}, PUT bytes, then call nitro_ingest with signed_id and use the returned media_url/image_url.

Clone design from existing template (email campaigns)

Optimistic concurrency token for patch/replace writes to an existing campaign template.

Target audience for the campaign. Use audience_type='all_contacts' only for an explicit all-subscribed-contacts send.

ISO 8601 delivery time (e.g. '2026-03-01T10:00:00Z'). Omit for manual send.

Preview campaign without creating (default: false)

Optional deduplication key

Required for replace mode

Which domain operation to perform:

• add — params: {domain_name (required, e.g. "send.acme.com"), author_domain (optional, e.g. "acme.com")}. Registers the technical sending domain with the email provider and returns DNS records. Managed SES also prepares the aligned visible From domain when the sending domain is a subdomain. Idempotent: calling add on a pending domain re-returns the DNS records.
• verify — params: {domain_name (required)}. Checks with the email provider if the core DNS records have propagated. Also runs independent DNS validation and returns per-record dns_health. Optional records like tracking are reported separately and do not block completion. If verified, completes the domain_verified onboarding step and unlocks sending. If still pending, returns the DNS records again so you can re-show them to the user.
• check_dns — params: {domain_name (required)}. Runs independent DNS validation plus live HTTPS readiness for branded tracking. Does not call the email provider. Useful for diagnosing missing or incorrect customer-facing records, Nitro-managed delegate targets, and tracking TLS failures before verify. Optional improvements are surfaced without blocking setup completion.
• list — no params needed. Returns all account domains with their verification status and DNS records. Includes dns_health, dmarc_policy, domain_limit (from tier), and domains_used count.
• remove — params: {domain_name (required)}. Deletes the domain. Requires confirm: true.