Skip to main content
Tomba
Previewv0.1.0
66 actions · 1 auth method
Developer ToolsCRMMarketing

Getting Started

1

Create or Select a Project

Set up a new project or select an existing one. See Organizations & Projects.
2

Configure the Connector

Enable the connector and set up a Connector Profile in your project. See Setup Connector Profile.

Connector Profile · API Key

Requires an API key and the account secret, both created in the Tomba dashboard. Keys expire after at most 365 days and…
3

Link an Account

Link an account from the dashboard (or via StackOne Hub).See the guide for the authentication type chosen in the Connector Profile:

Link Account · API Key

4

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.

Actions

66 actions
Action
Description
Retrieve API Logs
Returns your billable lookups, newest first, with what each one cost.
Retrieve API Usage
Returns your daily credit usage over a range of days, one row per user and day, with totals for the range.
Get Account
Returns your account, your plan, and your credit usage in the current usage window.
Retrieve A Single API Log
Returns one row of GET /logs by its id.
Retrieve Rate Limits
Returns, for every rate-limited route, the limits that apply to your account and the requests counted against them in th…
Get The Bulk Webhook Secret
Get the key your bulk job events are signed with.
Rotate The Bulk Webhook Secret
Replace the key your bulk job events are signed with.
List Bulk Jobs
List the jobs of a type, limit per page, sorted by job ID.
List Bulk Types
List every bulk type with its input fields and the header names detected for them, its options, row limit, daily limits,…
Download Bulk Job Results
Download a result file of a completed job as CSV.
Estimate Bulk Job Credits
Get the credits a job costs, and whether your balance covers them.
Get A Bulk Job
Get a job by ID, with its options in config, its results in metrics, and, once it is billed, the first result rows in pr…
Get Bulk Job History
List a job’s events, oldest first: creation, launch, start, end, retries, downloads, renames, archiving, and webhook del…
Get Bulk Job Progress
Get a job’s status, progress, estimated time left, and results so far.
Get Bulk Statistics
Get the bulk activity of your account, or of your workspace: jobs created by status, rows processed, results, and credit…
Cancel A Bulk Job
Cancel a pending job: its status becomes cancelled, and you can retry it later.
Create A Bulk Job
Create a job from a list of values, data rows, or a CSV file (multipart).
Retry A Bulk Job
Run a failed or cancelled job again from its input, with the same options.
Launch A Bulk Job
Start a pending job; any other status, or an expired job, returns 409.
Rename A Bulk Job
Rename a job.
Restore An Archived Bulk Job
Move an archived job back to the default list.
Archive A Bulk Job
Archive a completed, failed, or cancelled job: it leaves the default list and appears with archived=true.
Delete A Bulk Job
Delete a job.
Combined API
Returns the person behind an email address and the company behind its domain in one call, in Clearbit’s format: data.per…
Company API
Returns the company behind a domain in Clearbit’s Company API format: name, description, location, industry codes, socia…
Get Domain Suggestions
Returns up to five companies whose name or domain matches your query, with their domain and the number of email addresse…
List Similar Companies
Returns companies similar to a domain, such as competitors, 25 per page.
Domain Status
Tells you whether a domain, or the domain of an email address, belongs to a webmail provider such as Gmail or to a dispo…
Technology
Returns the technologies detected on a domain’s website, such as its analytics, live chat, and payment tools, with their…
Author Finder
Finds the email address of the author of an article or blog post from its URL.
Domain Search
Returns the company behind a domain and one page of the email addresses Tomba has for it, with each person’s name, job t…
Email Count
Returns how many email addresses Tomba has for a domain, by email type, department, and seniority.
Email Enrichment
Returns the person behind an email address, with their name, company, job title, social profiles, and the address’s veri…
Email Finder
Finds a person’s professional email address from their name and their company’s domain or name.
Email Format
Returns the formats that a domain’s email addresses follow, such as {first}.{last}, with the share of known addresses th…
Location
Returns, for each country, how many of a domain’s email addresses belong to people in that country.
Linkedin Finder
Finds the professional email address of the person behind a LinkedIn profile URL.
List My Flags
Returns the reports you submitted, with their review status and any credits returned.
Flag Incorrect Data
Reports incorrect data: an email address that bounced or is wrong, or a wrong organization, phone number, author URL, or…
Retrieve API Keys
Returns the API keys of your workspace: yours and every other member’s, including their full key values.
Retrieve A Single API Key
Returns one API key of your workspace, including its value.
Create An API Key
Creates an API key for your account and returns its value in data.message.
Reset An API Key
Rotates a key: issues a new value and a new 365-day expiry, and the old value stops working immediately.
Rename An API Key
Changes a key’s name.
Delete An API Key
Deletes a key.
Retrieve Lead Attributes
Returns up to 25 custom lead attributes of your workspace, or your own attributes when you aren’t in a workspace.
Retrieve A Single Lead Attribute
Confirms that an attribute exists in your workspace.
Create A Lead Attribute
Creates a custom lead attribute.
Update A Lead Attribute
Renames an attribute and sets its type.
Delete A Lead Attribute
Deletes an attribute of your workspace.
Retrieve Leads Lists
Returns up to 25 lead lists of your workspace, or your own lists when you aren’t in a workspace.
Retrieve A Single Leads List
Returns one lead list of your workspace.
Create Leads List
Creates a lead list.
Update Leads List
Renames a list of your workspace, or marks or unmarks it as a favorite.
Delete Leads List
Deletes a list of your workspace.
Retrieve Leads
Returns the leads of your workspace, or your own leads when you aren’t in a workspace, with each lead’s list and custom…
Retrieve A Single Lead
Returns one lead of your workspace, as the only item of data.leads.
Create A Lead
Saves a lead to your account.
Update A Lead
Updates a lead of your workspace.
Delete A Lead
Deletes a lead of your workspace, with its custom attribute values.
Person API
Returns the person behind an email address in Clearbit’s Person API format: name, location, employment, and social profi…
Phone Finder
Finds phone numbers for a person or a company from an email address, a domain, or a LinkedIn profile URL.
Phone Validator
Checks whether a phone number is valid in its country’s numbering plan and returns its formats, line type, carrier, regi…
Search Companies
Searches Tomba’s company database with structured filters or a natural-language query, and returns 50 companies per page…
Email Sources
Returns the public web pages where Tomba found an email address, with when it was first and last seen on each.
Email Verifier
Checks whether an email address can receive mail.