> ## Documentation Index
> Fetch the complete documentation index at: https://docs.manypi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Find your first leads, verify them, and send your first campaign.

This walkthrough takes you from a new account to a live cold-email campaign.
Every step also has an API and MCP equivalent, linked as you go.

<Note>
  The free plan finds and stores up to 50 leads and includes 50 email
  validations, so you can complete steps 1–3 without paying. **Sending** to
  leads (step 5) requires a paid plan.
</Note>

## Step 1 — Create your workspace

<Steps>
  <Step title="Sign up">
    Go to [app.manypi.com](https://app.manypi.com) and create an account.
  </Step>

  <Step title="Verify your email">
    Confirm the address so the workspace is activated.
  </Step>

  <Step title="Describe your brand">
    In **Settings → Brands**, tell ManyPI what you sell: website, a short
    description, your value proposition and who you sell to.

    This is not paperwork. The brand is injected into every lead search (so the
    agent can judge *"would this company want it?"*) and into every AI-drafted
    email. Skipping it is the single most common reason results feel generic.
  </Step>
</Steps>

## Step 2 — Find your first leads

Open **Leads → Find leads** and describe your ideal customer.

```text Example search theme={null}
E-commerce agencies in Germany and Austria, 5–50 employees,
that build Shopify stores. I need a contact email and the
founder or head of growth. Skip anyone who only does SEO.
```

Fill in the structured fields next to the description — locations, industries,
titles, required fields, and any **extra columns** you want researched (for
example `pricing_page` or `tech_stack`). Then set how many leads you want and
start the run.

The agent works asynchronously. It searches, crawls, cross-checks and saves
leads as it goes, and it will **pause and ask you a question** if your criteria
are ambiguous — answer it in the chat and the same run continues.

<Tip>
  Save the search as a profile. Re-running it later only saves *new* companies,
  so a saved search becomes a recurring lead source.
</Tip>

<Card title="Lead generation in depth" icon="crosshairs" href="/leads/finding-leads" horizontal>
  Criteria, seed leads ("find more like these"), custom columns and limits.
</Card>

## Step 3 — Verify the email addresses

Select your new leads and choose **Verify emails**. ManyPI does a real SMTP
mailbox probe from a dedicated sending IP and writes a status back onto each
lead: `valid`, `invalid`, `catch_all`, `no_mx`, `disposable` or `unknown`.

Addresses that are already known-good are free — you are only charged for
probes that actually run.

<Card title="Email validation" icon="circle-check" href="/leads/email-validation" horizontal>
  What each status means, what it costs, and how sends are blocked automatically.
</Card>

## Step 4 — Connect a sending inbox

Go to **Outreach → Sending** and connect the mailbox you want to send from.
Gmail and Outlook connect over OAuth; anything else works over SMTP.

Leave **warmup** on for a new domain. ManyPI ramps the daily volume up over
time instead of blasting from day one, and it stops sending automatically if
your bounce rate spikes.

<Warning>
  Send from a *secondary* domain, not your primary one. Cold outreach reputation
  damage is hard to undo and you do not want it on the domain your invoices come
  from.
</Warning>

## Step 5 — Write a sequence and launch

<Steps>
  <Step title="Create a sequence">
    **Outreach → Sequences → New**. Write step 1, then add follow-ups with a
    `wait_days` gap. Use merge variables so one template personalises across
    every lead:

    ```html theme={null}
    <p>Hi {{first_name}},</p>
    <p>I noticed {{company}} builds Shopify stores — we help agencies
    like yours find their next 20 clients without cold-calling.</p>
    <p>Worth a 15-minute look?</p>
    ```

    Or click **Draft with AI**, describe what you are selling, and let ManyPI
    write the whole sequence against your brand.
  </Step>

  <Step title="Create a campaign">
    A campaign binds one sequence to one sending inbox, and carries the send
    window, daily limit and tracking settings.
  </Step>

  <Step title="Enroll your leads">
    Select leads in the Leads grid and enroll them. Step 1 goes out on the next
    send slot; follow-ups are scheduled automatically and stop the moment
    someone replies.
  </Step>
</Steps>

<Check>
  You now have a running campaign. Watch **Outreach → Replies** for what comes
  back, and **Outreach → Overview** for sends, opens, replies and bounces.
</Check>

## Do the same thing over the API

Everything above is a REST call. Create an API key in **Settings → API keys**
and grant it the permissions you need.

<CodeGroup>
  ```bash Find leads theme={null}
  curl -X POST https://app.manypi.com/api/leads/research \
    -H "Authorization: Bearer mpi_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "criteria": {
        "description": "E-commerce agencies building Shopify stores",
        "locations": ["Germany", "Austria"],
        "titles": ["Founder", "Head of Growth"],
        "required_fields": ["email"],
        "count": 25
      }
    }'
  ```

  ```bash Verify addresses theme={null}
  curl -X POST https://app.manypi.com/api/leads/validate \
    -H "Authorization: Bearer mpi_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{ "lead_ids": ["8f1c…", "b207…"] }'
  ```

  ```bash Enroll into a campaign theme={null}
  curl -X POST https://app.manypi.com/api/outreach/enroll \
    -H "Authorization: Bearer mpi_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{ "campaign_id": "…", "lead_ids": ["8f1c…"] }'
  ```
</CodeGroup>

<Card title="API reference" icon="terminal" href="/api-reference/introduction" horizontal>
  Full endpoint reference, authentication and permission scopes.
</Card>

## Or drive it from your AI assistant

Connect the ManyPI MCP server once and your assistant can run the entire
workflow in conversation — find leads, draft the sequence, create the campaign
and enroll.

```bash Claude Code theme={null}
claude mcp add --transport http manypi https://mcp.manypi.com/mcp -s user
```

<Card title="MCP server" icon="plug" href="/mcp/introduction" horizontal>
  Setup for Claude, Cursor, VS Code, ChatGPT, Codex, Gemini CLI and more.
</Card>