Skip to main content

Run a lead agent

Three jobs for lead agents, each with the call that does it

Lead agents bill in runs from your plan and never use credits. See Lead agents.

List your agents​

curl -s https://app.makesmores.com/api/v1/agents \
  -H "Authorization: Bearer $SMORE_API_KEY" | tee agents.json

Hire an agent that finds buyers on X​

curl -s https://app.makesmores.com/api/v1/agents \
  -H "Authorization: Bearer $SMORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Founders looking for customers",
    "brief": {
      "who": "B2B founders with an early product",
      "signals": "Asking how to find their first customers",
      "never": "Job seekers and agencies selling services",
      "goal": "Start useful conversations"
    }
  }'

Run it and read its leads​

Starting a run spends one run from your plan. Send an idempotency_key so a retry returns the same run.

curl -s -X POST "https://app.makesmores.com/api/v1/agents/$AGENT_ID/runs" \
  -H "Authorization: Bearer $SMORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"idempotency_key": "founders-2026-10-24"}'

curl -s "https://app.makesmores.com/api/v1/leads?agent_id=$AGENT_ID&limit=20" \
  -H "Authorization: Bearer $SMORE_API_KEY"

Each lead carries the post, why the agent kept it, its score and a draft reply in your voice for you to approve in S'more.