ACTION_ID: octave_add_email_to_sequence_agent
NAME: Octave: Add email to sequence agent
CATEGORY: Outreach
CREDITS: 0

Run an Octave sequence agent against one prospect and return the
generated email templates, plus the product, playbook and persona the
agent used. It generates copy — it does not send anything.

PREREQUISITE: Octave account connection — the user must create it in the Floqer UI
(Connections page); an agent cannot. Without it the action fails the row with
a connection / authentication error. Confirm it exists before configuring.

1. INPUTS

agent_id (dynamicDropdown, required)
  Agent ID. Select the sequence agent you want to generate emails with

first_name (string, optional)
  First Name. The first name of the recipient

email (email, optional)
  Email. Email address of the recipient

job_title (string, optional)
  Job Title. Job title of the recipient

company_name (string, optional)
  Company Name. Company name of the recipient

company_domain (url, optional)
  Company Domain. Company domain of the recipient

linkedin_url (url, optional)
  LinkedIn URL. LinkedIn profile URL of the recipient

2. OUTPUTS

emails (json) — Generated emails by the sequence agent

product (json) — The product that was used in email generation

playbook (json) — The playbook that was used in email generation

persona (json) — The persona that was used in email generation

3. HOW TO CONFIGURE

Configure Action body:

{
  "inputs": {
    "agent_id": "<Octave sequence agent id>",
    "first_name": "{{input.first_name}}",
    "email": "{{person_work_email_waterfall_01ab.work_email}}",
    "job_title": "{{enrich_person_linkedin_profile_01cd.person_current_job_title}}",
    "company_name": "{{input.company_name}}",
    "company_domain": "{{input.company_domain}}",
    "linkedin_url": "{{input.linkedin_url}}"
  }
}

Field-by-field:
  - agent_id   The Octave sequence agent that writes the copy.
  - the rest   Context the agent personalises against. The more of these
               you wire, the better the generated copy — Octave has no
               enrichment of its own.

4. KEY NOTES

- This action generates email copy. Nothing is sent — pair it with a
  sequencer action (`instantly_add_to_campaign`,
  `smartleads_add_to_campaign`) to actually deliver it.
- `agent_id` has no dynamic-options resolver yet — Get Action Field
  Options returns a 400. Copy the agent ID from the Octave UI.
- All four outputs are `json` objects. Dotted nested reference syntax
  does not reach into them; pluck fields inside a `formula` with the
  bracket form, e.g.
  `{{octave_add_email_to_sequence_agent_01ab.emails}}?.[0]?.["subject"]`.
- Output quality tracks input completeness — an agent run with only an
  email produces generic copy.

5. WHERE IT FITS IN A WORKFLOW

Pattern: enrich_person_linkedin_profile -> floqer_company_firmographics
-> octave_add_email_to_sequence_agent -> formula (pluck subject/body) ->
instantly_add_to_campaign.

6. WHEN TO USE

Use octave_add_email_to_sequence_agent when Octave holds your messaging
playbooks and you want its agent — not a raw LLM prompt — to write the
sequence.

7. WHEN NOT TO USE

Need free-form generated copy from a prompt you control
  -> action-detail/llm_models.txt

Need live web research folded into the copy
  -> action-detail/llm_web_agents.txt

Last updated: 2026-08-03.