Salesprompter

Docs that map the app, CLI, and extension as one system.

Public documentation for the Salesprompter contracts, workflows, and runtime behavior. This deployment is generated directly from the docs source in the CLI repository.

Source repository

The sync:outreach --target instantly path is the first real downstream sync in this repository. It supports dry runs by default and real writes only when you explicitly opt in.

Required configuration

Variable or option Purpose
INSTANTLY_API_KEY API key used for campaign lookup and lead creation
INSTANTLY_CAMPAIGN_ID or --campaign-id target campaign
SALESPROMPTER_INSTANTLY_BASE_URL override the default Instantly API base URL

Default base URL:

https://api.instantly.ai/api/v2

Dry run versus apply

Dry run is the default:

node ./dist/cli.js sync:outreach --target instantly --in ./data/scored.json --campaign-id "$INSTANTLY_CAMPAIGN_ID"

Real write:

node ./dist/cli.js sync:outreach --target instantly --in ./data/scored.json --campaign-id "$INSTANTLY_CAMPAIGN_ID" --apply

Dedupe behavior

Unless you pass --allow-duplicates, the CLI:

  1. lists the current campaign leads from Instantly
  2. builds a set of existing emails
  3. skips any scored lead whose email is already present

Use --allow-duplicates only when you intentionally want to bypass that protection.

Payload mapping

For each scored lead, the CLI sends:

  • contact email
  • split first and last name
  • company name
  • campaign id
  • a rich custom_variables object containing Salesprompter fields

Current custom_variables include:

  • salesprompter_domain
  • salesprompter_title
  • salesprompter_industry
  • salesprompter_region
  • salesprompter_employee_count
  • salesprompter_source
  • salesprompter_score
  • salesprompter_grade
  • salesprompter_buying_stage
  • salesprompter_crm_fit
  • salesprompter_outreach_fit
  • salesprompter_signals
  • salesprompter_tech_stack
  • salesprompter_rationale

Typical output

The sync result reports:

  • target
  • number of synced leads
  • number of skipped leads, when dedupe is active
  • whether the run was dry run or applied
  • provider name
  • campaign id