ACTION_ID: push_data_to_campaign
NAME: Push to Campaign
CATEGORY: Floq Tools
CREDITS: 0

Add the rows that reach this step as leads to a Floqer campaign and
start their sequence. The native counterpart to the third-party
sequencer actions.

1. INPUTS

choose_a_campaign (dynamicDropdown, required)
  Choose a campaign. Campaign to push leads into

map_columns_to_lead_fields (raw_array, required)
  Map columns to lead fields. Match this workflow's columns to the
  campaign's lead fields. Email is required.

2. OUTPUTS

(none — this action writes to the destination and returns no fields)

3. HOW TO CONFIGURE

Resolve the campaign list:

  POST .../options/choose_a_campaign   (body: {})

Configure Action body:

{
  "inputs": {
    "choose_a_campaign": "<campaign id from options>",
    "map_columns_to_lead_fields": [
      { "name": "email", "value": "{{person_work_email_waterfall_01ab.work_email}}" },
      { "name": "first_name", "value": "{{input.first_name}}" },
      { "name": "company_name", "value": "{{input.company_name}}" }
    ]
  }
}

Field-by-field:
  - choose_a_campaign          The Floqer campaign to push into. Only
                               campaigns the API key's user owns or is
                               shared on are listed; archived campaigns
                               are excluded.
  - map_columns_to_lead_fields `[{name, value}]` mapping this sheet's
                               columns onto the campaign's lead fields.
                               `email` is required.

4. KEY NOTES

- Every row that reaches this step is pushed — put a `filter` upstream
  if only a subset should be enrolled.
- `email` must be mapped. Rows whose mapped email resolves empty fail
  rather than being skipped silently.
- The action produces no output fields; it is always the last step on
  its branch.
- The options response lists only non-archived campaigns owned by or
  shared with the API key's user — a campaign owned by a colleague and
  not shared will not appear.

5. WHERE IT FITS IN A WORKFLOW

Pattern: source import -> enrichment chain -> filter (ICP match) ->
push_data_to_campaign. The native alternative to pushing into Instantly
/ Smartlead.

6. WHEN TO USE

Use push_data_to_campaign when the sequence runs inside Floqer campaigns
rather than a third-party sending tool.

7. WHEN NOT TO USE

The sequence runs in an external tool
  -> action-detail/instantly_add_to_campaign.txt

Need to move rows to another sheet rather than a campaign
  -> action-detail/push_data_to_sheet.txt

Last updated: 2026-08-03.