NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Datagma connects to a Nagent workspace with an API key. Once it is connected, agents can call 8 Datagma actions, such as "Find Work Email", "Get Credits" and "Get Twitter Profile By Email". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Datagma, with input parameters and output schema.
DATAGMA_DETECT_JOB_CHANGETool to detect if a contact changed jobs. Use when verifying a contact’s current employment details by email.
Input parameters
Email address of the contact to check; must be a valid email format
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DATAGMA_ENRICH_PERSON_OR_COMPANYEnrich person or company data using LinkedIn URLs, emails, domains, or names. Returns enriched data including: contact information, LinkedIn profiles, company details, work experience, education, phone numbers (with phoneFull), and company metrics. Input types: LinkedIn profile URL (~100% success), email (~60% success), name+company (~90% success), company domain/name, or SIREN number (French companies).
Input parameters
Primary input: LinkedIn URL, domain, email, company name, or SIREN number.
Include lower-confidence matches and detailed scoring information when true.
Full name of person (alternative to firstName/lastName; required when phoneFull=true).
Last name of the person (use with firstName and company for name-based enrichment).
First name of the person (use with lastName and company for name-based enrichment).
Search for cell phone numbers when true (requires fullName or firstName+lastName).
Include full LinkedIn profile (education, experience, skills, posts) when true.
Include extended company data (funding, traffic, technologies, growth metrics) when true.
ISO country code (e.g., 'US', 'FR') to improve matching accuracy for person/company enrichment.
Include detailed website traffic analysis when true.
Include SIREN directory data for French companies when true.
Verify if returned phone numbers are linked to WhatsApp accounts when true.
Additional keywords to disambiguate company matches when multiple companies have similar names.
Include LinkedIn company information (employees, industry, location) when true.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DATAGMA_FIND_WORK_EMAILFind verified work email address for a person using their name and company. Returns a professionally verified email address with validation metadata including SMTP checks and MX records. Requires either fullName or firstName+lastName, plus company domain or LinkedIn company slug.
Input parameters
Company domain name (e.g., 'tesla.com') or company name. Required to identify the target company.
Full name of the person. Use this instead of firstName and lastName if you have the complete name.
Last name of the person to find email for. Can be used instead of fullName.
First name of the person to find email for. Can be used instead of fullName.
LinkedIn company slug URL. Accepts formats like 'https://www.linkedin.com/company/10625816', 'https://www.linkedin.com/company/livestorm/', or 'https://www.linkedin.com/sales/company/10625816'. If domain is not provided, it will be extracted from this.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DATAGMA_GET_CREDITSGet the current credit balance for the authenticated Datagma API account. Use this to check how many API credits remain before making enrichment calls.
Input parameters
Email address associated with the API account (optional). If not provided, uses the authenticated account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DATAGMA_GET_TWITTER_BY_EMAILRetrieve Twitter account information associated with an email address. This action looks up Twitter username and display name for a given email address using Datagma's enrichment database. Returns Twitter username, display name, and the queried email if a match is found, or status 'NOT_FOUND' if no Twitter account is associated with the email. Use this when you need to: - Find someone's Twitter handle from their email address - Verify if an email has an associated Twitter account - Enrich contact data with social media information
Input parameters
The email address to search for an associated Twitter account. Must be a valid email format.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DATAGMA_GET_TWITTER_BY_USERNAMEEnrich Twitter profile data using Datagma's database. Returns contact information (email), social media profiles (LinkedIn, Facebook, GitHub), and professional details (skills, interests, industry) associated with a Twitter username. Note: Not all usernames are in Datagma's database. A 'not found' response (code 5) indicates the username hasn't been indexed yet.
Input parameters
Twitter username without the '@' symbol (case-sensitive). Examples: 'jack', 'TwitterDev'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DATAGMA_REVERSE_PHONE_LOOKUPTool to reverse-lookup information associated with a phone number. Use when you have a phone number and need associated details (e.g., carrier, location).
Input parameters
Phone number in E.164 format (e.g., '+14155552671')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DATAGMA_SEARCH_PHONE_NUMBERSFind mobile phone numbers using email address and/or LinkedIn profile URL. Returns list of phone numbers with confidence scores and optional WhatsApp verification. Best results when both email and LinkedIn URL are provided.
Input parameters
Datagma API key. Optional when Authorization header is provided by the connection.
Email address to search phone numbers for. Combine with username for best results.
LinkedIn or social media profile URL. Combine with email for best results.
Minimum confidence threshold for results (1-100). Lower values return more results with potentially lower confidence.
Enable WhatsApp verification for returned phone numbers. Adds processing time.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 8 Datagma actions on Nagent, including "Find Work Email", "Get Credits" and "Get Twitter Profile By Email". Find Work Email: Find verified work email address for a person using their name and company. Each action is listed on this page with its input parameters and its output.
Datagma connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It also takes 5 optional inputs: company, fullName, lastName, firstName and linkedInSlug. It returns data, error and successful.