> ## 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 > How to set up the Tomba connector, plus the actions that are available. ![Tomba](https://stackone-logos.com/api/tomba/filled/svg) Previewv0.2.0[See changelog](https://docs.stackone.com/connectors/tomba/changelog.md) [66 actions](#actions) · 2 auth methods Developer Tools CRM Marketing ## Getting Started **1. Create or Select a Project** Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md). **2. Configure the Connector** 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). > [card] [API Key · Connector Profile](https://docs.stackone.com/connectors/tomba/guides/connector-profile/api-key.md) > > Requires an API key and the account secret, both created in the Tomba dashboard. Keys expire after at most 365 days and... > [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/tomba/guides/connector-profile/oauth-2-0.md) > > Acts as the signed-in Tomba user, limited to the scopes they approve. Requires registering a public OAuth client with To... **3. Link an Account** Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)). See the guide for the authentication type chosen in the Connector Profile: > [card] [API Key · Link Account](https://docs.stackone.com/connectors/tomba/guides/link-account/api-key.md) > [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/tomba/guides/link-account/oauth-2-0.md) **4. Use Actions** Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/connect/ai-platforms/overview.md). Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md). ## Actions Authentication type Select all | Clear API Key OAuth 2.0 No auth methods found Scopes Select all | Clear account enrich leads read search verify No scopes found 66 actions ActionDescriptionRequired scopes Retrieve API Logs`tomba_list_logs` Returns your billable lookups, newest first, with what each one cost. Retrieve API Usage`tomba_list_usage` Returns your daily credit usage over a range of days, one row per user and day, with totals for the range. Get Account`tomba_get_account` Returns your account, your plan, and your credit usage in the current usage window. `read` Retrieve A Single API Log`tomba_get_log` Returns one row of GET /logs by its id. Retrieve Rate Limits`tomba_get_rate_limits` Returns, for every rate-limited route, the limits that apply to your account and the requests counted against them in th... `read` Get The Bulk Webhook Secret`tomba_get_bulk_webhook_secret` Get the key your bulk job events are signed with. `leads` Rotate The Bulk Webhook Secret`tomba_rotate_bulk_webhook_secret` Replace the key your bulk job events are signed with. `leads` List Bulk Jobs`tomba_list_bulk_jobs` List the jobs of a type, limit per page, sorted by job ID. `leads` List Bulk Types`tomba_list_bulk_types` List every bulk type with its input fields and the header names detected for them, its options, row limit, daily limits,... `leads` Download Bulk Job Results`tomba_download_bulk_job_results` Download a result file of a completed job as CSV. `leads` Estimate Bulk Job Credits`tomba_estimate_bulk_job_credits` Get the credits a job costs, and whether your balance covers them. `leads` Get A Bulk Job`tomba_get_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... `leads` Get Bulk Job History`tomba_get_bulk_job_history` List a job's events, oldest first: creation, launch, start, end, retries, downloads, renames, archiving, and webhook del... `leads` Get Bulk Job Progress`tomba_get_bulk_job_progress` Get a job's status, progress, estimated time left, and results so far. `leads` Get Bulk Statistics`tomba_get_bulk_stats` Get the bulk activity of your account, or of your workspace: jobs created by status, rows processed, results, and credit... `leads` Cancel A Bulk Job`tomba_cancel_bulk_job` Cancel a pending job: its status becomes cancelled, and you can retry it later. `leads` Create A Bulk Job`tomba_create_bulk_job` Create a job from a list of values, data rows, or a CSV file (multipart). `leads` Retry A Bulk Job`tomba_retry_bulk_job` Run a failed or cancelled job again from its input, with the same options. `leads` Launch A Bulk Job`tomba_launch_bulk_job` Start a pending job; any other status, or an expired job, returns 409. `leads` Rename A Bulk Job`tomba_rename_bulk_job` Rename a job. `leads` Restore An Archived Bulk Job`tomba_restore_bulk_job` Move an archived job back to the default list. `leads` Archive A Bulk Job`tomba_archive_bulk_job` Archive a completed, failed, or cancelled job: it leaves the default list and appears with archived=true. `leads` Delete A Bulk Job`tomba_delete_bulk_job` Delete a job. `leads` Combined API`tomba_get_combined` Returns the person behind an email address and the company behind its domain in one call, in Clearbit's format: data.per... `enrich` Company API`tomba_get_company` Returns the company behind a domain in Clearbit's Company API format: name, description, location, industry codes, socia... `enrich` Get Domain Suggestions`tomba_list_domain_suggestions` Returns up to five companies whose name or domain matches your query, with their domain and the number of email addresse... `search` List Similar Companies`tomba_list_similar_companies` Returns companies similar to a domain, such as competitors, 25 per page. `search` Domain Status`tomba_get_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... `read` Technology`tomba_get_technology` Returns the technologies detected on a domain's website, such as its analytics, live chat, and payment tools, with their... `search` Author Finder`tomba_author_finder` Finds the email address of the author of an article or blog post from its URL. `search` Domain Search`tomba_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... `search` Email Count`tomba_email_count` Returns how many email addresses Tomba has for a domain, by email type, department, and seniority. `read` Email Enrichment`tomba_email_enrichment` Returns the person behind an email address, with their name, company, job title, social profiles, and the address's veri... `enrich` Email Finder`tomba_email_finder` Finds a person's professional email address from their name and their company's domain or name. `search` Email Format`tomba_email_format` Returns the formats that a domain's email addresses follow, such as \{first}.\{last}, with the share of known addresses th... `read` Location`tomba_get_location` Returns, for each country, how many of a domain's email addresses belong to people in that country. `read` Linkedin Finder`tomba_linkedin_finder` Finds the professional email address of the person behind a LinkedIn profile URL. `search` List My Flags`tomba_list_flags` Returns the reports you submitted, with their review status and any credits returned. Flag Incorrect Data`tomba_create_flag` Reports incorrect data: an email address that bounced or is wrong, or a wrong organization, phone number, author URL, or... Retrieve API Keys`tomba_list_api_keys` Returns the API keys of your workspace: yours and every other member's, including their full key values. `account` Retrieve A Single API Key`tomba_get_api_key` Returns one API key of your workspace, including its value. `account` Create An API Key`tomba_create_api_key` Creates an API key for your account and returns its value in data.message. `account` Reset An API Key`tomba_reset_api_key` Rotates a key: issues a new value and a new 365-day expiry, and the old value stops working immediately. `account` Rename An API Key`tomba_rename_api_key` Changes a key's name. `account` Delete An API Key`tomba_delete_api_key` Deletes a key. `account` Retrieve Lead Attributes`tomba_list_lead_attributes` Returns up to 25 custom lead attributes of your workspace, or your own attributes when you aren't in a workspace. `leads` Retrieve A Single Lead Attribute`tomba_get_lead_attribute` Confirms that an attribute exists in your workspace. `leads` Create A Lead Attribute`tomba_create_lead_attribute` Creates a custom lead attribute. `leads` Update A Lead Attribute`tomba_update_lead_attribute` Renames an attribute and sets its type. `leads` Delete A Lead Attribute`tomba_delete_lead_attribute` Deletes an attribute of your workspace. `leads` Retrieve Leads Lists`tomba_list_lead_lists` Returns up to 25 lead lists of your workspace, or your own lists when you aren't in a workspace. `leads` Retrieve A Single Leads List`tomba_get_lead_list` Returns one lead list of your workspace. `leads` Create Leads List`tomba_create_lead_list` Creates a lead list. `leads` Update Leads List`tomba_update_lead_list` Renames a list of your workspace, or marks or unmarks it as a favorite. `leads` Delete Leads List`tomba_delete_lead_list` Deletes a list of your workspace. `leads` Retrieve Leads`tomba_list_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... `leads` Retrieve A Single Lead`tomba_get_lead` Returns one lead of your workspace, as the only item of data.leads. `leads` Create A Lead`tomba_create_lead` Saves a lead to your account. `leads` Update A Lead`tomba_update_lead` Updates a lead of your workspace. `leads` Delete A Lead`tomba_delete_lead` Deletes a lead of your workspace, with its custom attribute values. `leads` Person API`tomba_get_person` Returns the person behind an email address in Clearbit's Person API format: name, location, employment, and social profi... `enrich` Phone Finder`tomba_phone_finder` Finds phone numbers for a person or a company from an email address, a domain, or a LinkedIn profile URL. `search` Phone Validator`tomba_phone_validator` Checks whether a phone number is valid in its country's numbering plan and returns its formats, line type, carrier, regi... `read` Search Companies`tomba_search_companies` Searches Tomba's company database with structured filters or a natural-language query, and returns 50 companies per page... `search` Email Sources`tomba_email_sources` Returns the public web pages where Tomba found an email address, with when it was first and last seen on each. `enrich` Email Verifier`tomba_email_verifier` Checks whether an email address can receive mail. `verify` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.