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
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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>Create the Datagma connection
In AgentKit > Connections, create a Datagma connection. The name you give it is the
connection_nameyour code passes. See Configure connections.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.actionsconst connector = 'datagma'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'datagma_credits_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "datagma"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Datagma:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="datagma_credits_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach 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 toexecute_tooldatagma_credits_getGet the Datagma account's information and remaining credit balance.Read-onlyGet 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-onlyReverse 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-onlyGet 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-onlyCheck 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-onlyFind 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-onlyEnrich 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-onlyReverse 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.
datagma_phone_searchFind a person's mobile phone number from their social profile URL and/or email address.Read-onlyFind Mobile Phone
Find a person's mobile phone number from their social profile URL and/or email address. Returns matching phone numbers with match details and, when requested, WhatsApp status. Send both username and email for the best match rate. Use datagma_person_enrich with phone_full when you only have a name and company. Charged per match.
Inputs
emailstring- Email address of the person. Example: raphael@datagma.com.
minimum_matchnumber- Minimum match score. 1 is recommended; lower values return more but less accurate results. Example: 1.
usernamestring- Social profile URL of the person, such as https://linkedin.com/in/username. Sales Navigator URLs are not accepted. Example: https://linkedin.com/in/raphaelazot.
whatsapp_checkboolean- Set to true to check whether the number has a WhatsApp account. Example: true.
datagma_siren_findFind a French company's SIREN registration number from its domain, name or LinkedIn page.Read-onlyFind French SIREN Number
Find a French company's SIREN registration number from its domain, name or LinkedIn page. Returns the matching SIREN number and company details. Send at least one input; the domain is usually the most reliable.
Inputs
company_linkedin_idstring- Company LinkedIn numeric ID. Example: 1441.
company_linkedin_sales_nav_idstring- Company Sales Navigator ID. Example: 1441.
company_linkedin_sales_nav_urlstring- Company Sales Navigator URL. Example: https://www.linkedin.com/sales/company/1441.
company_linkedin_urlstring- Company LinkedIn page URL. Example: https://www.linkedin.com/company/septodont/.
company_namestring- Company name. Example: Septodont.
domainstring- Company website domain. Example: septodont.fr.
datagma_tech_stack_getGet the technologies a company's website uses.Read-onlyGet Website Tech Stack
Get the technologies a company's website uses. Returns the detected technologies for the domain. Use this for technographic prospecting.
Inputs
domainstringrequired- Website domain to analyze, without https://. Example: salesforce.com.
datagma_twitter_by_email_getFind a person's Twitter (X) profile from their email address.Read-onlyGet Twitter Profile by Email
Find a person's Twitter (X) profile from their email address. Returns the Twitter username and profile data when found. Use datagma_twitter_by_username_get when you have a username or LinkedIn URL.
Inputs
emailstringrequired- Email address of the person. Example: jane.doe@example.com.
datagma_twitter_by_username_getGet a Twitter (X) profile by username, or find it from a LinkedIn profile.Read-onlyGet Twitter Profile by Username
Get a Twitter (X) profile by username, or find it from a LinkedIn profile. Returns the Twitter profile data when found. Send username or linkedin. Use datagma_twitter_by_email_get to start from an email.
Inputs
linkedinstring- LinkedIn profile URL without https://, in the form linkedin.com/in/username. Example: linkedin.com/in/raphaelazot.
usernamestring- Twitter username, case sensitive. Example: raphaelazot.
datagma_website_traffic_getGet traffic estimates for a company's website.Read-onlyGet Website Traffic
Get traffic estimates for a company's website. Returns traffic data for the domain. Use this to size or qualify a company.
Inputs
domainstringrequired- Website domain to analyze, without https://. Example: salesforce.com.
datagma_work_email_findFind and verify a person's work email from their name and company or company LinkedIn page.Read-onlyFind Work Email
Find and verify a person's work email from their name and company or company LinkedIn page. Returns the verified email when found, or a most probable email for unverifiable catch-all domains (not billed). Use this before outreach. Use datagma_person_enrich for a full profile. No credit is used when no verified email is found.
Inputs
companystring- Company domain or name. Send this or linkedin_slug. Example: datagma.com.
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.
last_namestring- Person's last name. Example: Azot.
linkedin_slugstring- Company LinkedIn URL, such as https://www.linkedin.com/company/livestorm/, when you do not have the domain. Example: https://www.linkedin.com/company/datagma/.
No tools match.