ACTION_ID: la_growth_machine_add_to_audience
NAME: LaGrowth Machine: Add Leads to a Audience
CATEGORY: sheets
CREDITS: 0

Add a lead to an audience in LaGrowthMachine.

================================================================================
PREREQUISITE — USER ACTION REQUIRED
================================================================================

This action only works if the user has connected their LaGrowthMachine
account in Floqer. The connection cannot be made via the API or by an AI
agent.

The user must do this themselves before this action will run:
  1. Sign in to Floqer at https://app.floqer.com
  2. Open the Connections page from the sidebar
  3. Click LaGrowthMachine and complete the OAuth flow

If the user has not connected LaGrowthMachine, this action will fail
with a connection / authentication error. Before configuring or running
this action, confirm with the user that the LaGrowthMachine connection
exists.

INDEX:
  1. Inputs
  2. Outputs
  3. How to configure
  4. Key notes
  5. Where it fits in a workflow
  6. When to use
  7. When not to use

================================================================================
1. INPUTS
================================================================================

audience (dynamicDropdown, required)
  Audience. The audience to add the lead to. Values from the
  lagrowthmachine list.

linkedin_url (url, optional) — LinkedIn URL.
first_name (string, optional) — First Name.
last_name (string, optional) — Last Name.
company_name (string, optional) — Company Name.
company_domain (url, optional) — Company Domain.
gender (dropdown, optional) — Gender. Values: man, woman.
bio (string, optional) — Bio.
job_title (string, optional) — Job Title.
twitter (string, optional) — Twitter.
email (email, optional) — Email. The Pro-Email of the Lead.
phone (string, optional) — Phone.
custom_attribute_1..custom_attribute_10 (string, optional) — Custom
  Attributes. Free-form per-lead values referenced as `{{customAttribute1}}`
  ... `{{customAttribute10}}` in the LaGrowthMachine sequence template.
location (string, optional) — Location.
personal_email (email, optional) — Personal Email.

================================================================================
2. OUTPUTS
================================================================================

status (string) — Status. e.g. "completed".

================================================================================
3. HOW TO CONFIGURE
================================================================================

Resolve the audience list via Get Action Field Options:

  POST /api/v1/workflows/{workflow_id}/sheets/{sheet_id}/actions/{action_instance_id}/options/audience
       (body: {})

Configure Action body:

{
  "inputs": {
    "audience": "<lgm_audience_id>",
    "email": "{{input.email}}",
    "first_name": "{{input.first_name}}",
    "last_name": "{{input.last_name}}",
    "company_name": "{{input.company_name}}",
    "linkedin_url": "{{input.linkedin_url}}",
    "company_domain": "{{input.company_domain}}",
    "job_title": "{{input.job_title}}",
    "custom_attribute_1": "{{llm_models_1.generated_content}}"
  }
}

Field-by-field:
  - audience              LaGrowthMachine audience ID from the
                          `audience` options call.
  - email                 Lead's email — usually `{{input.email}}`.
  - first_name / last_name /
    company_name /
    company_domain /
    linkedin_url /
    job_title / location /
    phone / personal_email
    bio / twitter / gender  Optional lead profile fields.
  - custom_attribute_1
    .. custom_attribute_10  Per-lead values referenced as
                            `{{customAttribute1}}`..`{{customAttribute10}}`
                            in the LaGrowthMachine sequence template —
                            common slot for AI-generated content from
                            upstream `llm_models`.

================================================================================
4. KEY NOTES
================================================================================

- LaGrowthMachine custom variables are positional (`custom_attribute_1`
  ..`custom_attribute_10`), not named — make sure the sequence template
  references the same numbered slot you populate here.
- `custom_attribute_*` slots are the canonical place for
  AI-generated per-lead content from upstream `llm_models` steps.

================================================================================
5. WHERE IT FITS IN A WORKFLOW
================================================================================

Pattern: contact discovery -> person_work_email_waterfall ->
person_work_email_verification_by_* -> llm_models ->
la_growth_machine_add_to_audience.

================================================================================
6. WHEN TO USE
================================================================================

Use la_growth_machine_add_to_audience to enroll leads in a
LaGrowthMachine audience.

================================================================================
7. WHEN NOT TO USE
================================================================================

Need a different sender (Instantly, Lemlist, Smartlead, Reply, HeyReach)
  -> instantly_add_to_campaign, lemlist_add_lead_to_campaign,
     smartleads_add_to_campaign,
     reply_add_and_push_to_campaign,
     heyreach_add_leads_to_campaign
     (https://floqer.com/docs/action-detail/<action_id>.txt)

Need AI-generated email content
  -> llm_models (upstream of this action; pass the generated content
     via `custom_attribute_*`)
     (https://floqer.com/docs/action-detail/llm_models.txt)

================================================================================

This file is maintained manually. Last updated: 2026-05-01.
Full interactive reference: https://floqer.com/docs/reference
Action catalog: https://floqer.com/docs/action-catalog.txt