Overview
The Datagma node for n8n, when configured with the Contact resource and the Enrich operation, allows users to enrich contact or company data using the Datagma API. This enrichment can be performed by providing various identifiers such as a professional email address, LinkedIn profile URL, company name, website, SIREN number, or combinations of personal and company information. The node is particularly useful for sales, marketing, or HR teams looking to gather detailed information about people or companies for lead generation, prospecting, or research.
Practical examples:
- Enriching a list of leads with additional company and person details before importing them into a CRM.
- Obtaining company financials, employee lists, or direct dial phone numbers for targeted outreach.
- Researching prospects by submitting only partial information (e.g., full name + company).
Properties
| Name | Type | Meaning |
|---|---|---|
| Data | String | Submit a professional email address, LinkedIn profile URL, company name, website, or SIREN to retrieve information about a person and their company. If not provided, you can use First Name + Last Name + Company instead. |
| Company Keyword | String | Optional keyword to help disambiguate between companies with similar names (e.g., part of the address, founder's name, industry). Used when searching for company information via the Data parameter. |
| First Name | String | Person's first name. Use in combination with Last Name and Company if Data is not provided. |
| Last Name | String | Person's last name. Use in combination with First Name and Company if Data is not provided. |
| Company | String | Company name. Required if using First Name and Last Name instead of Data. |
| Additional Fields | Collection | Extra options to refine the enrichment request: • Full Name (String): Alternative to First Name/Last Name. • Company Premium (Boolean): Get LinkedIn info about the company. • Company Full (Boolean): Get company financials. • Company French (Boolean): Get SIREN directory info for French companies. • Person Full (Boolean): Get full person profile. • Phone (Boolean): Direct dial phone (beta, non-EU only). • Company Phone (Boolean): Office/HQ phone. • Deep Traffic (Boolean): Website traffic analytics. • Company Employees (Boolean): Get company employees. • Employee Title (String): Filter returned employees by title (requires Company Employees). • Max employees to return (Number): Limit number of employees returned (requires Company Employees). • Employee Country (String): Filter employees/person by country. • Debug (String): Enable debug mode to access filtered/junk results. |
Output
The node returns an array of JSON objects, each containing the enriched data retrieved from the Datagma API. The structure of the output depends on the input parameters and the available data, but typically includes:
- Person information: Name, job title, email, LinkedIn profile, education, work history, etc.
- Company information: Name, website, industry, size, location, LinkedIn page, financials, SIREN data (for French companies), employees, phone numbers, website traffic, etc.
- Additional fields: Depending on selected options (e.g., debug info, deep traffic analytics, employee lists).
Note: The node does not output binary data; all responses are in JSON format.
Dependencies
- External Service: Requires a Datagma API account and API key.
- n8n Credentials: You must configure the
datagmaApicredential in n8n with your API key. - Network Access: n8n instance must be able to reach
https://gateway.datagma.net.
Troubleshooting
Common Issues:
- Invalid or missing API key: Ensure your Datagma API credentials are correctly set up in n8n.
- Insufficient input data: If required fields (such as Data, or First Name + Last Name + Company) are missing, the API may return errors or empty results.
- API rate limits or quota exceeded: If you exceed your Datagma plan's limits, requests may fail.
- Incorrect parameter combinations: Some options (like Employee Title or Max employees to return) only work if "Company Employees" is enabled.
Error Messages & Resolutions:
- 401 Unauthorized / Invalid API Key: Double-check your API key in n8n credentials.
- 400 Bad Request / Missing Parameters: Make sure you provide either the Data field or the correct combination of First Name, Last Name, and Company.
- Empty or incomplete results: Try enabling Debug mode in Additional Fields to see filtered/junk results.