Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Datagma

Scalekit connector
Open markdown

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

Tools
14
What they doRead · write · destructive
14 · 0 · 014 read0 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 Datagma connection

    In AgentKit > Connections, create a Datagma 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 = 'datagma'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Datagma:', 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: 'datagma_credits_get',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Datagma 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
  • datagma_credits_getGet the Datagma account's information and remaining credit balance.Read-only

    Get Credit Balance

    Get the Datagma account's information and remaining credit balance. Returns the account details and current credits. Use this before bulk enrichment to check credits. Free; no credit is used.

    Inputs

    This tool takes no inputs.

  • datagma_email_reverse_lookupIdentify the person behind a personal email address (addresses outside the EU only).Read-only

    Reverse Email Lookup

    Identify the person behind a personal email address (addresses outside the EU only). Returns the person's name and profile details when found. Use datagma_person_enrich for professional email addresses.

    Inputs

    emailstringrequired
    Personal email address to look up. Example: john.smith@gmail.com.
  • datagma_funding_getGet the funding rounds a company has raised.Read-only

    Get Company Funding

    Get the funding rounds a company has raised. Returns funding data for the company's domain. Use this to find recently funded companies or qualify accounts.

    Inputs

    domainstringrequired
    Company website domain, without https://. Example: salesforce.com.
  • datagma_job_change_checkCheck in real time whether a contact still works at their last known company or has moved.Read-only

    Check Job Change

    Check in real time whether a contact still works at their last known company or has moved. Returns whether the person changed company and, if so, their current company and job title. Use this to keep CRM contacts current.

    Inputs

    company_namestring
    Last known company of the person. Example: Datagma.
    first_namestring
    Person's first name. Example: Raphael.
    full_namestring
    Person's full name. Send this or first_name and last_name. Example: Raphael Azot.
    job_titlestring
    Last known job title, to pick the right person when several share the name. Example: CEO.
    last_namestring
    Person's last name. Example: Azot.
  • datagma_people_findFind up to 10 people who hold given job titles at a company.Read-only

    Find People at Company

    Find up to 10 people who hold given job titles at a company. Returns matching people with their name, job title and profile details. Use this to find decision makers, then datagma_work_email_find or datagma_person_enrich for contact data. A successful search costs 10 credits; an empty one costs 1.

    Inputs

    countriesstring
    Country name in lowercase. Example: united states.
    current_companiesstring
    Company name, the least accurate company input. Example: Algolia.
    current_job_titlestring
    Job title to search for. Separate alternatives with OR. Example: head of sales OR VP sales OR CRO.
    debugboolean
    Set to true to turn off the filter that drops non-relevant job titles. Example: false.
    domainstring
    Company domain, less accurate than linkedin_id but better than the name. Example: algolia.com.
    fuzzyboolean
    Set to true for approximate matching, which broadens results but can reduce accuracy. Example: false.
    linkedin_idstring
    Company's LinkedIn numeric ID, the most accurate company input. Example: 2728700.
  • datagma_person_enrichEnrich a person (from a work email, a LinkedIn profile URL, or a name plus company in data) or a company (from a name, website or French SIREN number) with Datagma's B2B data.Read-only

    Enrich Person or Company

    Enrich a person (from a work email, a LinkedIn profile URL, or a name plus company in data) or a company (from a name, website or French SIREN number) with Datagma's B2B data. Returns person fields (name, job title, location, LinkedIn data, and with the options full profile and mobile phone) and company fields (name, domain, industry, size, LinkedIn and optional financial or traffic data). Use this as the main enrichment call. Use datagma_work_email_find to find an email and datagma_phone_search when you already have a profile URL or email. A person match costs 2 credits; options can cost more.

    Inputs

    company_frenchboolean
    Set to true to add SIREN directory data for a French company. Example: false.
    company_fullboolean
    Set to true to add the company's financial information. Example: false.
    company_keywordstring
    Keyword to pick the right company when several share a name, such as part of the address, a founder's name or the industry. Example: Paris.
    company_premiumboolean
    Set to true to add the LinkedIn data of the person's company. Example: true.
    country_codestring
    Country code to narrow the search and avoid namesakes. Example: FR.
    datastring
    Work email or LinkedIn profile URL to enrich a person; or a company name, website or SIREN number to get company data. To enrich a person by name, put their company name or domain here and set full_name (or first_name and last_name). Example: https://www.linkedin.com/in/raphaelazot.
    debugboolean
    Set to true to also return results Datagma would filter out as low quality. Example: false.
    deep_trafficboolean
    Set to true to add the company website's traffic (by country, by source, similar sites). Example: false.
    first_namestring
    First name of the person, used with last_name and the company in data. Example: Raphael.
    full_namestring
    Full name, instead of first_name and last_name. Example: Raphael Azot.
    last_namestring
    Last name of the person, used with first_name and the company in data. Example: Azot.
    person_fullboolean
    Set to true to add the person's full profile (education, past experience). Example: true.
    phone_fullboolean
    Set to true to look for the person's mobile phone. Use datagma_phone_search instead when you have their profile URL or email. Example: false.
  • datagma_phone_reverse_lookupIdentify the person behind a phone number.Read-only

    Reverse Phone Lookup

    Identify the person behind a phone number. Returns the person's name and profile details when found. Use this to identify an inbound caller or a number in your CRM.

    Inputs

    numberstringrequired
    Phone number without the country code. Example: 665409047.
    codestring
    Country calling code with the plus sign. Example: +33.