Datagma icon

Datagma

Consume Datagma API

Actions2

Overview

The Datagma node for n8n allows you to interact with the Datagma API to find professional email addresses based on contact information.
Specifically, the Contact → Find operation enables users to search for a person's business email address using their first name, last name (or full name), and company name.

Common scenarios:

  • Automating lead enrichment by finding emails for sales or marketing outreach.
  • Verifying or supplementing CRM data with missing professional email addresses.
  • Integrating with workflows that require validated contact information for further processing.

Practical example:
Suppose you have a list of people with their names and companies but lack their email addresses. You can use this node in an n8n workflow to automatically retrieve their business emails from Datagma and update your database.


Properties

Name Type Meaning
First Name String First name of the person. Can be left blank if Full Name is provided.
Last Name String Last name of the person. Can be left blank if Full Name is provided.
Company String Required. The company name associated with the person.
Additional Fields > Full Name String If first and last names are not provided, specify the full name here.

Output

The output is a JSON object containing the response from the Datagma API's findEmail endpoint.
The structure typically includes fields such as:

{
  "email": "[email protected]",
  "status": "found",
  "confidence": 95,
  // ...other metadata returned by Datagma
}
  • The exact fields depend on the API response, but you can expect at least the found email and some status/confidence indicators.
  • No binary data is produced by this operation.

Dependencies

  • External Service: Requires access to the Datagma API.
  • API Key: You must configure Datagma API credentials (datagmaApi) in n8n.
  • n8n Configuration: Ensure the node has network access to https://gateway.datagma.net.

Troubleshooting

Common issues:

  • Missing or invalid API key:

    • Error: 401 Unauthorized or similar authentication errors.
    • Solution: Check that your Datagma API credentials are correctly set up in n8n.
  • Insufficient input data:

    • Error: API returns an error indicating required fields are missing.
    • Solution: Ensure you provide at least the company name and either first/last name or full name.
  • No email found:

    • Error: Response indicates no result or low confidence.
    • Solution: Double-check the spelling of names and company, or try providing more complete information.
  • API rate limits or quota exceeded:

    • Error: API returns a message about too many requests or quota exhaustion.
    • Solution: Wait before retrying or upgrade your Datagma plan.

Links and References

Discussion