Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Tomba

Scalekit connector
Open markdown

The Tomba connector lets your AI agent act in each user's Tomba account. Each user connects their own Tomba API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 29 tools.

Tools
29
What they doRead · write · destructive
28 · 1 · 028 read1 write0 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv

  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Create the Tomba connection

    In AgentKit > Connections, create a Tomba connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENVIRONMENT_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'tomba'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Tomba:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'tomba_domain_search',
      toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Tomba credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • tomba_enrich_emailGet the person behind an email address in Tomba's own format.Read-only

    Enrich Email

    Get the person behind an email address in Tomba's own format. Returns data with the person's name, position, department, seniority, company, social profiles and the address's verification status. data.email is null when Tomba has no data, and data.disposable and data.webmail still describe the domain. Use tomba_enrich_email for a Tomba-format person profile. Use tomba_get_person for Clearbit's Person format, tomba_get_combined_profile for person plus company in one call, and tomba_verify_email for deliverability only.

    Inputs

    emailstringrequired
    The email address to enrich. Example: jane.doe@stripe.com.
    enrich_mobileboolean
    Set to true to also return the person's phone numbers in phone_data. Phone numbers cost extra Tomba credits. Default false.default false
  • tomba_find_author_emailFind the email address of the author of an article or blog post from its URL.Read-only

    Find Author Email

    Find the email address of the author of an article or blog post from its URL. Returns data.email with the author's name, position, company and verification status, and data.info with the article and every author candidate. data.email is null when no address is found. Use tomba_find_author_email when all you have is an article URL. Use tomba_find_email when you know the person's name and company.

    Inputs

    urlstringrequired
    URL of the article or blog post. The scheme is optional. Example: https://stripe.com/blog/online-payments-guide.
  • tomba_find_emailFind one person's professional email address from their name and their company's domain or name.Read-only

    Find Email

    Find one person's professional email address from their name and their company's domain or name. Returns data.email with a confidence score, the person's name, position, company, social profiles and verification status. data.email is null when no address is found. Use tomba_find_email when you know the person's name and company. Use tomba_find_email_by_linkedin for a LinkedIn profile URL, tomba_find_author_email for an article URL, and tomba_domain_search to list everyone at a company. Send domain or company, and first_name plus last_name or full_name.

    Inputs

    companystring
    Company name, 3 to 75 characters, used when domain is not sent. A domain gives better results. Example: Stripe.
    domainstring
    Company domain. Send domain or company; when both are sent, domain is used. Webmail domains such as gmail.com fail with 400. Example: stripe.com.
    enrich_mobileboolean
    Set to true to also return the person's phone numbers in phone_data. Phone numbers cost extra Tomba credits. Default false.default false
    first_namestring
    The person's first name. Send first_name and last_name together, or full_name. Example: Jane.
    full_namestring
    The person's full name, 5 to 80 characters, used when first_name and last_name are not both sent. Example: Jane Doe.
    last_namestring
    The person's last name. Send it with first_name. Example: Doe.
  • tomba_find_email_by_linkedinFind the professional email address of the person behind a LinkedIn profile URL.Read-only

    Find Email by LinkedIn

    Find the professional email address of the person behind a LinkedIn profile URL. Returns data.email with the person's name, position, company, social profiles and verification status, or with full=true an array of up to two stored addresses. data.email is null when no address is found. Use tomba_find_email_by_linkedin when you have a LinkedIn URL. Use tomba_find_email when you have a name and company, and tomba_find_phone for phone numbers from the same URL.

    Inputs

    urlstringrequired
    LinkedIn profile URL. Example: https://www.linkedin.com/in/jane-doe.
    enrich_mobileboolean
    Set to true to also return the person's phone numbers in phone_data. Phone numbers cost extra Tomba credits. Default false.default false
    fullboolean
    Set to true to return an array of the addresses Tomba has stored for the profile (up to two) instead of the single most likely one. phone_data is not included in this mode. Default false.default false
  • tomba_find_phoneFind phone numbers for a person or a company from an email address, a company domain or a LinkedIn profile URL.Read-only

    Find Phone

    Find phone numbers for a person or a company from an email address, a company domain or a LinkedIn profile URL. Returns data with the number in local, international and E.164 formats, its validity, line type, carrier, region and time zones, or an array of every number found with full=true. data is an empty array when nothing is found. Use tomba_find_phone to get a number you don't have. Use tomba_validate_phone to check and format a number you already have. Send at least one of email, domain and linkedin; the numbers found for each are merged.

    Inputs

    domainstring
    Company domain, to get the company's phone number. Sending a domain changes the credit cost. Example: stripe.com.
    emailstring
    Email address of the person. Example: jane.doe@stripe.com.
    fullboolean
    Set to true to return an array of every number found instead of a single number. Default false.default false
    linkedinstring
    LinkedIn profile URL of the person. Example: https://www.linkedin.com/in/jane-doe.
  • tomba_find_similar_domainsList companies similar to a domain, such as competitors, 25 per page.Read-only

    Find Similar Domains

    List companies similar to a domain, such as competitors, 25 per page. Returns data with each similar company's website_url, name and industries, with paging in meta. data is null when there are none. Use tomba_find_similar_domains to expand a prospect list from one known company. Use tomba_search_companies to search by industry, size, location or technology instead. Send domain or company.

    Inputs

    companystring
    Company name, 3 to 75 characters. When Tomba knows the company, its domain is used even if domain is also sent. Example: Stripe.
    domainstring
    Company domain to find similar companies for. Send domain or company. Example: stripe.com.
    limitinteger
    Accepted for compatibility: the page size is always 25, but limit sets the credit cost. One of 10, 20, 50, 100, 150, 200, 250. Default 10.one of 102050100150200250default 10
    pageinteger
    Page number, starting at 1. Default 1.default 1
  • tomba_get_combined_profileGet the person behind an email address and the company behind its domain in one call, in Clearbit's format.Read-only

    Get Person and Company

    Get the person behind an email address and the company behind its domain in one call, in Clearbit's format. Returns data.person (Person API fields) and data.company (Company API fields). When the person has no match the response carries an errors object (not_found or params_invalid) instead of data. Use tomba_get_combined_profile when you need both profiles. Use tomba_get_person or tomba_get_company when you need only one.

    Inputs

    emailstringrequired
    The email address to look up. Example: jane.doe@stripe.com.
All 103 in CRM & Sales