> 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 -X POST https://sumble.com/paid-api/organizations/find \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filters": {"technologies": ["react"]}, "limit": 5}'
```

Replace `YOUR_API_KEY` with the key you generated in the previous step.

A successful response looks like this:

```json
{
  "id": "0199f400-4123-7eca-9082-be2c94676bfc",
  "credits_used": 5,
  "credits_remaining": 9895,
  "total": 48291,
  "organizations": [
    {
      "id": 1726684,
      "name": "Acme Corp",
      "domain": "acme.com",
      "industry": "Information",
      "total_employees": 320,
      "headquarters_country": "US",
      "url": "https://sumble.com/l/org/TH2y9mGkRr1q"
    }
  ]
}
```

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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sumble.com/get-started/get-started-with-sumble.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.