Twenty icon

Twenty

Interact with the Twenty API

Actions25

Person → Find by Email

AI-generated

Overview

This node interacts with the Twenty API to find a person by their email address within a Twenty workspace. It is useful for scenarios where you need to retrieve detailed information about a person based on their email, such as in CRM integrations, contact management, or automated workflows that require person data lookup.

Use Case Examples

  1. Find a person by email to enrich contact details in a CRM system.
  2. Retrieve person information to trigger personalized email campaigns.
  3. Lookup a person's data before creating or updating records in other systems.

Properties

Name Meaning
Base URL Base URL for the Twenty workspace REST API, including the /rest suffix.
Email The email address to search for the person.
Depth Controls how much related data is returned by the API, either primary object only or including direct relations.
Limit Maximum number of results to return from the search.
Request Options Additional request settings such as batching, SSL certificate validation, proxy, and timeout options.

Output

JSON

  • id - Unique identifier of the found person.
  • email - Email address of the found person.
  • name - Name of the found person.
  • relatedObjects - Related data objects if depth option includes relations.

Dependencies

  • Requires an API key credential for authentication with the Twenty API.

Troubleshooting

  • Ensure the Base URL is correctly set with the /rest suffix to avoid connection errors.
  • Verify the API key credential is valid and has necessary permissions to access person data.
  • If no results are returned, check that the email address is correct and exists in the Twenty workspace.
  • Adjust the 'Depth' and 'Limit' parameters to control the amount of data returned and avoid timeouts or large payloads.
  • If SSL errors occur, consider enabling 'Ignore SSL Issues' only if you trust the network environment.

Links

Discussion