> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Datagma

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.

**Authentication:** API Key
**Categories:** CRM & Sales, Analytics
**Tools:** 14: 14 read, 0 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=DATAGMA)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".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](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   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)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_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.actions

   connection_name = "datagma"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_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 call
   result = actions.execute_tool(
       tool_input={},
       tool_name="datagma_credits_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Datagma credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'datagma_credits_get',
  toolInput: {},
  connector: 'datagma',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="datagma_credits_get",
    tool_input={},
    connection_name="datagma",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `datagma_credits_get`

Get Credit Balance · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `datagma_email_reverse_lookup`

Reverse Email Lookup · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email` (`string`, required): Personal email address to look up. Example: john.smith@gmail.com.

Example input: `{"email":"<email>"}`

### `datagma_funding_get`

Get Company Funding · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain` (`string`, required): Company website domain, without https://. Example: salesforce.com.

Example input: `{"domain":"<domain>"}`

### `datagma_job_change_check`

Check Job Change · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_name` (`string`, optional): Last known company of the person. Example: Datagma.
- `first_name` (`string`, optional): Person's first name. Example: Raphael.
- `full_name` (`string`, optional): Person's full name. Send this or first_name and last_name. Example: Raphael Azot.
- `job_title` (`string`, optional): Last known job title, to pick the right person when several share the name. Example: CEO.
- `last_name` (`string`, optional): Person's last name. Example: Azot.

Example input: `{}`

### `datagma_people_find`

Find People at Company · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `countries` (`string`, optional): Country name in lowercase. Example: united states.
- `current_companies` (`string`, optional): Company name, the least accurate company input. Example: Algolia.
- `current_job_title` (`string`, optional): Job title to search for. Separate alternatives with OR. Example: head of sales OR VP sales OR CRO.
- `debug` (`boolean`, optional): Set to true to turn off the filter that drops non-relevant job titles. Example: false.
- `domain` (`string`, optional): Company domain, less accurate than linkedin_id but better than the name. Example: algolia.com.
- `fuzzy` (`boolean`, optional): Set to true for approximate matching, which broadens results but can reduce accuracy. Example: false.
- `linkedin_id` (`string`, optional): Company's LinkedIn numeric ID, the most accurate company input. Example: 2728700.

Example input: `{}`

### `datagma_person_enrich`

Enrich Person or Company · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_french` (`boolean`, optional): Set to true to add SIREN directory data for a French company. Example: false.
- `company_full` (`boolean`, optional): Set to true to add the company's financial information. Example: false.
- `company_keyword` (`string`, optional): 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_premium` (`boolean`, optional): Set to true to add the LinkedIn data of the person's company. Example: true.
- `country_code` (`string`, optional): Country code to narrow the search and avoid namesakes. Example: FR.
- `data` (`string`, optional): 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.
- `debug` (`boolean`, optional): Set to true to also return results Datagma would filter out as low quality. Example: false.
- `deep_traffic` (`boolean`, optional): Set to true to add the company website's traffic (by country, by source, similar sites). Example: false.
- `first_name` (`string`, optional): First name of the person, used with last_name and the company in data. Example: Raphael.
- `full_name` (`string`, optional): Full name, instead of first_name and last_name. Example: Raphael Azot.
- `last_name` (`string`, optional): Last name of the person, used with first_name and the company in data. Example: Azot.
- `person_full` (`boolean`, optional): Set to true to add the person's full profile (education, past experience). Example: true.
- `phone_full` (`boolean`, optional): 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.

Example input: `{}`

### `datagma_phone_reverse_lookup`

Reverse Phone Lookup · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `number` (`string`, required): Phone number without the country code. Example: 665409047.
- `code` (`string`, optional): Country calling code with the plus sign. Example: +33.

Example input: `{"number":"<number>"}`

### `datagma_phone_search`

Find Mobile Phone · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email` (`string`, optional): Email address of the person. Example: raphael@datagma.com.
- `minimum_match` (`number`, optional): Minimum match score. 1 is recommended; lower values return more but less accurate results. Example: 1.
- `username` (`string`, optional): 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_check` (`boolean`, optional): Set to true to check whether the number has a WhatsApp account. Example: true.

Example input: `{}`

### `datagma_siren_find`

Find French SIREN Number · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_linkedin_id` (`string`, optional): Company LinkedIn numeric ID. Example: 1441.
- `company_linkedin_sales_nav_id` (`string`, optional): Company Sales Navigator ID. Example: 1441.
- `company_linkedin_sales_nav_url` (`string`, optional): Company Sales Navigator URL. Example: https://www.linkedin.com/sales/company/1441.
- `company_linkedin_url` (`string`, optional): Company LinkedIn page URL. Example: https://www.linkedin.com/company/septodont/.
- `company_name` (`string`, optional): Company name. Example: Septodont.
- `domain` (`string`, optional): Company website domain. Example: septodont.fr.

Example input: `{}`

### `datagma_tech_stack_get`

Get Website Tech Stack · Read-only

Get the technologies a company's website uses.
Returns the detected technologies for the domain.
Use this for technographic prospecting.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain` (`string`, required): Website domain to analyze, without https://. Example: salesforce.com.

Example input: `{"domain":"<domain>"}`

### `datagma_twitter_by_email_get`

Get Twitter Profile by Email · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email` (`string`, required): Email address of the person. Example: jane.doe@example.com.

Example input: `{"email":"<email>"}`

### `datagma_twitter_by_username_get`

Get Twitter Profile by Username · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `linkedin` (`string`, optional): LinkedIn profile URL without https://, in the form linkedin.com/in/username. Example: linkedin.com/in/raphaelazot.
- `username` (`string`, optional): Twitter username, case sensitive. Example: raphaelazot.

Example input: `{}`

### `datagma_website_traffic_get`

Get Website Traffic · Read-only

Get traffic estimates for a company's website.
Returns traffic data for the domain.
Use this to size or qualify a company.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain` (`string`, required): Website domain to analyze, without https://. Example: salesforce.com.

Example input: `{"domain":"<domain>"}`

### `datagma_work_email_find`

Find Work Email · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company` (`string`, optional): Company domain or name. Send this or linkedin_slug. Example: datagma.com.
- `first_name` (`string`, optional): Person's first name. Example: Raphael.
- `full_name` (`string`, optional): Person's full name. Send this or first_name and last_name. Example: Raphael Azot.
- `last_name` (`string`, optional): Person's last name. Example: Azot.
- `linkedin_slug` (`string`, optional): 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/.

Example input: `{}`

## Related

Other CRM & Sales connectors ([all 174](/agentkit/connectors/?category=crm-sales)):

- [Salesforce](/agentkit/connectors/salesforce/): Scalekit connector, OAuth, 74 tools
- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Close](/agentkit/connectors/close/): Scalekit connector, OAuth, 103 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
