Get started with Sumble

Go from account creation to your first organization search and API call in under 10 minutes. This guide walks you through every step.

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.

1

Create your account

Go to 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.

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.

2

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.

Free plan users can see the first page of results for any search. Upgrade to Pro to access up to 10 pages.

3

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.

4

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.

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.

For full details on securing and using your key, see the API section.

5

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:

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:

{
  "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 section to find organizations by any combination of filters, enrich them with detailed data, search for people, and more.