ACTION_ID: aimfox_add_profiles_to_campaign
NAME: AimFox: Add Profile to Campaign
CATEGORY: Outreach
CREDITS: 0

Add a LinkedIn profile to an AimFox campaign, optionally with
per-campaign custom variables used by the campaign's message templates.

PREREQUISITE: AimFox 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

campaign (dynamicDropdownFirst, required)
  Campaign. Select the AimFox campaign to add the profile to

linkedin_profile_url (url, required)
  LinkedIn Profile URL. The LinkedIn URL of the profile to add to the
  campaign

custom_variables (raw_array, optional)
  Custom Variables. Custom variable values for this campaign (keys are
  fetched from the selected campaign)

2. OUTPUTS

status (string) — Status/Response of the request

3. HOW TO CONFIGURE

Resolve the campaign first — the custom-variable keys are defined
per campaign, so pick the campaign before writing `custom_variables`:

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

Configure Action body:

{
  "inputs": {
    "campaign": "<campaign id from options>",
    "linkedin_profile_url": "{{input.linkedin_url}}",
    "custom_variables": [
      { "name": "icebreaker", "value": "{{llm_models_01ab.generated_content}}" }
    ]
  }
}

Field-by-field:
  - campaign               AimFox campaign to enrol the profile in.
  - linkedin_profile_url   Person profile URL (`/in/<handle>`). A company
                           page URL is rejected by AimFox.
  - custom_variables       `[{name, value}]` where each `name` is a
                           variable key defined on the selected campaign.

4. KEY NOTES

- Custom-variable keys belong to the campaign, not the workspace.
  Changing `campaign` invalidates any `custom_variables` you already
  wrote — re-check the campaign's variables after switching.
- The URL must be a personal profile. Company pages and Sales Navigator
  lead URLs are not accepted; resolve a flagship `/in/` URL upstream
  first.
- Only `status` comes back. There is no AimFox lead ID to chain from.
- There is no dynamic-options resolver for `custom_variables` yet — read
  the variable keys from the campaign in the AimFox UI and pass them as
  literal `name` values.

5. WHERE IT FITS IN A WORKFLOW

Pattern: get_linkedin_post_reactors -> push_data_to_sheet (fan out
reactors) -> llm_models (write an icebreaker) ->
aimfox_add_profiles_to_campaign.

6. WHEN TO USE

Use aimfox_add_profiles_to_campaign to run LinkedIn outreach through
AimFox against profiles a Floqer workflow has sourced and personalised.

7. WHEN NOT TO USE

Need HeyReach for the LinkedIn campaign instead
  -> action-detail/heyreach_add_leads_to_campaign.txt

Need an email sequence rather than LinkedIn
  -> action-detail/smartleads_add_to_campaign.txt

Last updated: 2026-08-03.