> For the complete documentation index, see [llms.txt](https://docs.sumble.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sumble.com/get-started/get-started-with-sumble.md).

# Get started with Sumble

This guide walks you through creating a Sumble account, running your first search, setting up signals for target accounts, and making your first API call. You can complete the web app steps without any technical setup. The API steps require a Pro plan or an active free trial.

{% stepper %}
{% step %}

### Create your account

Go to [sumble.com](https://sumble.com) and click **Create Free account**.

Sign up with your work email address. Using a work email unlocks a 30-day Pro trial automatically, no credit card required. You'll receive a magic link by email; click it to complete sign-in.

{% hint style="info" %}
If your company is already in Sumble's database, signing up with your work email also gives the MCP server contextual awareness of your own tech stack for smarter recommendations.
{% endhint %}
{% endstep %}

{% step %}

### Explore the web app

Once you're logged in, you land on the organization search view. Use the filter panel to narrow down companies by what you care about:

* **Technologies:** find companies using a specific framework, language, or tool (e.g., Snowflake, React, Kubernetes)
* **Job function:** filter by the types of roles organizations are actively hiring for
* **Firmographics:** industry, location, and company size

Click any organization card to open its profile. You'll see a technology breakdown, recent hiring activity, and (on Pro) a list of people within the company.

{% hint style="info" %}
Free plan users can see the first page of results for any search. Upgrade to Pro to access up to 10 pages.
{% endhint %}
{% endstep %}

{% step %}

### Set up signals for target accounts

Signals notify you when companies you're tracking show hiring activity that indicates a relevant project or budget is in motion.

1. Open an organization's profile.
2. Click **Follow** to add it to your signal watchlist.
3. Go to **Account > Settings** to configure how you receive signal alerts: in the app, by weekly email digest, or via Slack.

Free plan users receive up to 7 signals per week. Pro users receive up to 20 signals per day.
{% endstep %}

{% step %}

### Generate your first API key

API access is available on Pro and Enterprise plans. To generate a key:

1. Go to **Account > API Keys** in the top-right menu.
2. Enter a name for your key (e.g., `my-first-key` or the name of the integration you're building).
3. Click **Create Key**.
4. Copy the token immediately. It's only shown once.

{% hint style="warning" %}
Your API key is shown in full only at creation time. Copy it before closing the dialog. If you lose it, delete the key and generate a new one.
{% endhint %}

For full details on securing and using your key, see the [API](/api/api.md) section.
{% endstep %}

{% step %}

### Make your first API call

With your API key in hand, you can query Sumble's organization search endpoint. The following example finds companies using React:

```bash
curl https://api.sumble.com/v9/organizations \
  --request POST \
  --header "Authorization: Bearer $YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data @- <<'EOF'
{
  "filter": {
    "query": "technology EQ 'react'"
  },
  "select": {
    "attributes": [
      "employee_count",
      "industry",
      "headquarters_country",
      "jobs_count"
    ]
  },
  "limit": 10,
  "order_by_column": "employee_count",
  "order_by_direction": "DESC"
}
EOF
```

Set `YOUR_API_KEY` in your environment (`export YOUR_API_KEY=...`) before running, or replace `$YOUR_API_KEY` in the command with the key you generated in the previous step.

A successful response looks like this:

```json
{
  "id": "0199f400-4123-7eca-9082-be2c94676bfc",
  "credits_used": 50,
  "credits_remaining": 9850,
  "total": 48291,
  "organizations": [
    {
      "attributes": {
        "id": 1726684,
        "name": "Acme Corp",
        "slug": "acme-corp",
        "url": "acme.com",
        "sumble_url": "https://sumble.com/l/org/TH2y9mGkRr1q",
        "employee_count": 320,
        "industry": "Information",
        "headquarters_country": "US",
        "jobs_count": 42
      },
      "entities": []
    }
  ],
  "source_data_url": "https://sumble.com/l/search/Xa1b2C3d4E5f"
}
```

From here, explore the full [API](/api/api.md) section to find organizations by any combination of filters, enrich them with detailed data, search for people, and more.
{% endstep %}
{% endstepper %}