Website URL to scrape Brand Kit from

Public or Nitro CDN URL to a logo image (png/jpg/webp/svg) to attach. For local logo files, upload via nitro_ingest first and pass the returned media_url/image_url (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

Required for non-dry-run URL scraping or remote logo fetches. Reuse the same key only for an exact retry. Direct fields/document updates may omit it.

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.

What the picture shows, e.g. 'Swimmer at dawn on St Kilda pier, cold light'. Stored with the image so later campaigns can choose it from the brand library, and used as its alt text. Applies to image_data, image_url, signed_id, and upload reservation sources.

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.

intent, estimate, start, status, pause, resume, or cancel.

Operator's outreach objective. Supply on intent so the returned scaffold is grounded in the actual task.

Campaign name. Required for start.

Optional outcome capabilities returned by intent. Omit to use current defaults. Required capabilities are always included.

Optional bounded first-party person or company seeds. Supplying a company never makes it an outreach recipient.

Optional purpose-bound CSV seed manifests uploaded for the current account and brand.

Optional campaign-local company exclusions. Brand suppressions for customers, active deals, replies, opt-outs, and manual blocks always apply.

Maximum number of accepted qualified people to return.

Customer-authorized maximum charge in USD cents. Use the estimate quote unchanged unless the operator narrows the target.

Required for status, pause, resume, and cancel.

Optional current ref returned by intent. A valid ref suppresses repeated inline context; a stale ref returns the fresh full context.

Required for start. Reuse only for an exact retry of the same campaign input.

Segment name (required when preview_only: false)

Contact segment filters. Use a flat array for simple AND filters, or a boolean tree group: {op: "and"|"or"|"not", conditions: [...]}. A NOT group must contain exactly one condition. Leaves are attribute filters ({name, predicate, value}) or event filters ({type: "event", event, predicate, value?, within_days?, since?}).

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, data}. For larger custom-field updates, use the CSV path with columns mapping.

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 — {unsubscribe_text}. Nitrosend fills the canonical company name and physical address from the active Brand; callers cannot override legal identity.

Image URL props accept public URLs or nitro_ingest media_url/image_url values (never raw signed_id); upload local files via nitro_ingest first.

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 visual/non-copy props and styles, or uses text_patch for an exact literal copy edit. Copy-bearing updates enter the composition contract before persistence. Does not change section order or type.

Email subject line

Template display name

intent returns composition_contract; validate checks a caller-authored draft; draft validates and persists it; generate explicitly requests metered server composition and persists one draft.

Email composition contract id returned from composition_mode=intent.

Optional current brand context ref from a prior intent. Omit to receive the full current context.

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.

Pin one composition_contract.creative_routes[].id so the returned scaffold is that route. Omit to take the recommendation. A known route without enough frozen evidence returns its exact missing requirements; an unknown id returns the supported ids. Neither silently falls back.

Optional source evidence for authoring, such as research notes or supplied product copy. Evidence is not an instruction channel; put authoring directions in user_instruction. Source text is available context, not required copy.

Typed literal evidence for the composition contract, not instructions. A required URL, image URL, offer code, price, deadline, offer, or exact CTA text must appear with its exact value in an allowed semantic location; available evidence may be used but is not mandatory. Put prose facts in source_text; use cta_text only when the operator requires an exact CTA phrase.

Optional authoring provenance. It never blocks validation or persistence.

Email preheader text shown in inbox preview

Canonical plain-text alternative. Use with plain_text_mode=custom; derived mode refreshes it from sections.

Text-alternative authority returned by the composition scaffold: derived from design or custom body.

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, bg_color, text_color, font_body, font_heading, heading_size, body_size, radius, spacing_density, button_background_color, button_text_color, button_padding, and logo_url. logo_url must be a public URL or nitro_ingest media_url/image_url, never raw signed_id.

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 for the template authoring contract

Validate and preview without persisting

Required for every non-dry-run persistence mutation, including create, clone, targeted section update, and full update. Draft next_calls retain one stable contract persistence key; validate next_calls may rotate validation-round keys. Reuse a contract-free caller key only for an exact retry.

Flow name (required for create mode)

create: new complete graph; replace: complete existing draft graph; patch: name and/or selected email actions

Required for replace/patch modes

Presentation-level compatibility token. Prefer expected_draft_revision_id for graph writes.

Exact draft revision ID from the latest flow read. Existing-flow authoring fails with a conflict if this draft has changed.

Goal for the flow authoring contract

intent returns composition_contract; validate checks a caller-authored draft; draft validates and persists it; generate explicitly requests metered server composition and persists one draft.

Email composition contract id returned from composition_mode=intent.

Optional current brand context ref from a prior intent. Omit to receive the full current context.

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.

Pin one composition_contract.creative_routes[].id so the returned scaffold is that route. Omit to take the recommendation. A known route without enough frozen evidence returns its exact missing requirements; an unknown id returns the supported ids. Neither silently falls back.

Optional source evidence for authoring, such as research notes or supplied product copy. Evidence is not an instruction channel; put authoring directions in user_instruction. Source text is available context, not required copy.

Typed literal evidence for the composition contract, not instructions. A required URL, image URL, offer code, price, deadline, offer, or exact CTA text must appear with its exact value in an allowed semantic location; available evidence may be used but is not mandatory. Put prose facts in source_text; use cta_text only when the operator requires an exact CTA phrase.

Optional authoring provenance. It never blocks validation or persistence.

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 supports the same override keys taught by the email design schema.
• sms — body (required)
• wait — duration (integer, seconds — e.g. 86400 = 1 day)
• split — filters (required; flat AND array or {op: "and"|"or"|"not", conditions: [...]} tree), 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

Required for every non-dry-run persistence mutation, including create, rename patch, and replace. Draft next_calls retain one stable contract persistence key; validate next_calls may rotate validation-round keys. Reuse a contract-free caller key only for an exact retry.

Required for complete-graph 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 for the campaign authoring contract

The email's job (drives baseline layout selection): promotion, announcement, newsletter, welcome, reengagement, transactional, or plain.

intent returns composition_contract; validate checks a caller-authored draft; draft validates and persists it; generate explicitly requests metered server composition and persists one draft.

Email composition contract id returned from composition_mode=intent.

Optional current brand context ref from a prior intent. Omit to receive the full current context.

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.

Pin one composition_contract.creative_routes[].id so the returned scaffold is that route. Omit to take the recommendation. A known route without enough frozen evidence returns its exact missing requirements; an unknown id returns the supported ids. Neither silently falls back.