Tomba OAuth 2.0 connector profile – StackOne setup guide

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

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.

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"
  }'

grant_types must include refresh_token so StackOne can renew the access token. Access tokens last 15 minutes.

Copy the client ID

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

Tomba OAuth 2.0 connector profile – StackOne setup guide

Register an OAuth client

Create the StackOne Connector Profile

​Register an OAuth client

​Create the StackOne Connector Profile

Register an OAuth client

Create the StackOne Connector Profile