Conductor API docs

curl -s https://api.conductor.fyi/v1/keys \
  -H "Authorization: Bearer $CONDUCTOR_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","scopes":["send"],"environment":"test","daily_send_cap":200}'
# -> { ..., "key": "ck_test_..." }   the secret is shown ONCE. Store it.

API=https://api.conductor.fyi   KEY=ck_test_...   # your test key

# 1) Check the sending domain (free, unmetered). Fix anything failing first.
curl -s $API/v1/check -H "Content-Type: application/json" \
  -d '{"domain":"yourco.com"}'
# -> composite_score, spf, dkim, dmarc, mx, blacklists

# 2) Find your connected mailbox id (one-time human step: OAuth consent
#    in the web app, or GET /v1/mailboxes/oauth/gmail/start for the URL)
curl -s $API/v1/mailboxes -H "Authorization: Bearer $KEY"
# -> [{ "id": "<MAILBOX_ID>", "warmup_state": "warming", "health": ... }]

# 3) Import contacts (consent gate + idempotent retry)
curl -s $API/v1/contacts/import \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "rows": [
      {"email":"jane@acme.com","first_name":"Jane","company":"Acme"},
      {"email":"raj@globex.com","first_name":"Raj","company":"Globex"}
    ],
    "column_map": {"email":"email","first_name":"first_name","company":"company"},
    "list_name": "July prospects",
    "consent_attested": true
  }'
# -> { "imported": 2, "skipped": 0, "suppressed": 0, "list_id": "<LIST_ID>" }
# Verification runs in the background. Invalid contacts are skipped at send time.

# 4) Lint the copy (free). If the score is low, POST /v1/copy/improve.
curl -s $API/v1/copy/lint \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"subject":"Quick question, {{first_name}}","body":"Hi {{first_name}}, saw {{company}} is hiring SDRs. We cut ramp time to 2 weeks for teams like yours. Worth a 15-min chat Thursday?"}'
# -> { "score": 92, "issues": [] }   aim for 80+

# 5) Create the sequence
curl -s $API/v1/sequences \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{
    "name": "SDR intro",
    "status": "active",
    "steps": [
      {"step_order":0,"delay_days":0,"subject_template":"Quick question, {{first_name}}","body_template":"...","stop_on_reply":true},
      {"step_order":1,"delay_days":3,"subject_template":"Re: Quick question, {{first_name}}","body_template":"...","stop_on_reply":true}
    ]
  }'
# -> { "id": "<SEQ_ID>", ... }

# 6) Create the campaign, enroll the list, launch (idempotent)
curl -s $API/v1/campaigns \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"name":"July outbound","sequence_id":"<SEQ_ID>","mailbox_ids":["<MAILBOX_ID>"]}'
# -> { "id": "<CAMPAIGN_ID>", "status": "draft" }

curl -s $API/v1/campaigns/<CAMPAIGN_ID>/enroll \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"list_id":"<LIST_ID>"}'
# -> { "enrolled": 2, "skipped_suppressed": 0, "skipped_duplicate": 0 }

curl -s $API/v1/campaigns/<CAMPAIGN_ID>/start \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"copy_quality":"warn"}'
# -> { "status": "active", ... }

curl -s $API/v1/campaigns/<CAMPAIGN_ID> -H "Authorization: Bearer $KEY"  # funnel stats
curl -s $API/v1/replies -H "Authorization: Bearer $KEY"                   # unified inbox
curl -s $API/v1/usage -H "Authorization: Bearer $KEY"                     # meters