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

# Tomba OAuth 2.0 connector profile – StackOne setup guide

> Set up a connector profile using OAuth 2.0 for Tomba in StackOne to allow users to link their accounts.

Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## Register an OAuth client

Tomba has no dashboard screen for OAuth clients. Register one with a single request to its client registration endpoint.

**1. Register the client**

Enables actions: Archive A Bulk Job, Author Finder, Cancel A Bulk Job, Combined API, Company API, Create A Bulk Job, Create A Lead, Create A Lead Attribute, Create An API Key, Create Leads List, Delete A Bulk Job, Delete A Lead, Delete A Lead Attribute, Delete An API Key, Delete Leads List, Domain Search, Domain Status, Download Bulk Job Results, Email Count, Email Enrichment, Email Finder, Email Format, Email Sources, Email Verifier, Estimate Bulk Job Credits, Get A Bulk Job, Get Account, Get Bulk Job History, Get Bulk Job Progress, Get Bulk Statistics, Get Domain Suggestions, Get The Bulk Webhook Secret, Launch A Bulk Job, Linkedin Finder, List Bulk Jobs, List Bulk Types, List Similar Companies, Location, Person API, Phone Finder, Phone Validator, Rename A Bulk Job, Rename An API Key, Reset An API Key, Restore An Archived Bulk Job, Retrieve A Single API Key, Retrieve A Single Lead, Retrieve A Single Lead Attribute, Retrieve A Single Leads List, Retrieve API Keys, Retrieve Lead Attributes, Retrieve Leads, Retrieve Leads Lists, Retrieve Rate Limits, Retry A Bulk Job, Rotate The Bulk Webhook Secret, Search Companies, Technology, Update A Lead, Update A Lead Attribute, Update Leads List

Run this request, replacing `<CALLBACK_URL>` with the **Callback URL** from your Connector Profile. The client is public and uses PKCE, so no client secret is needed.

```bash theme={null}
curl -X POST 'https://api.tomba.io/v1/oauth/register' \
  -H 'Content-Type: application/json' \
  -d '{
    "client_name": "StackOne Integration",
    "redirect_uris": ["<CALLBACK_URL>"],
    "grant_types": ["authorization_code", "refresh_token"],
    "response_types": ["code"],
    "token_endpoint_auth_method": "none",
    "scope": "search verify enrich leads account read"
  }'
```

<ul>
  <li>`grant_types` must include `refresh_token` so StackOne can renew the access token. Access tokens last 15 minutes.</li>
</ul>

<ul>
  <li>
    search
  </li>

  <li>
    verify
  </li>

  <li>
    enrich
  </li>

  <li>
    leads
  </li>

  <li>
    account
  </li>

  <li>
    read
  </li>
</ul>

**2. Copy the client ID**

Copy the `client_id` from the response into your Connector Profile as the **Client ID**.

## Create the StackOne Connector Profile

**1. Create a Connector Profile**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

**2. Link an Account**

Once the Connector Profile is created, continue to [link an account](https://docs.stackone.com/connectors/tomba/guides/link-account/oauth-2-0.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.