Twenty icon

Twenty

Interact with the Twenty API

Actions25

Person → Create

AI-generated

Overview

This node interacts with the Twenty API to create a new person record in a Twenty workspace. It is useful for automating the addition of contact information into the Twenty system, such as when integrating with CRM workflows or onboarding processes. For example, it can be used to add a new employee or client contact with details like name, email, company association, and additional personal information.

Use Case Examples

  1. Creating a new person with first name, last name, and primary email to add to the Twenty workspace.
  2. Adding a person with additional details such as job title, LinkedIn profile, and phone number for enriched contact records.

Properties

Name Meaning
Base URL Base URL for the Twenty workspace REST API endpoint.
First Name Given name of the person to create.
Last Name Family name of the person to create.
Primary Email Primary email address used to identify the person.
Company ID Identifier of the Twenty company to associate with the person.
Additional Fields Optional additional details about the person such as city, job title, LinkedIn info, phone numbers, and custom fields in JSON format.
Request Options Settings for request behavior such as batching, SSL certificate validation, proxy, and timeout.

Output

JSON

  • id - Unique identifier of the created person.
  • firstName - First name of the created person.
  • lastName - Last name of the created person.
  • primaryEmail - Primary email address of the created person.
  • companyId - Associated company ID for the person.
  • additionalFields - Additional optional fields provided during creation, such as job title, city, LinkedIn URL, phone numbers, and custom fields.

Dependencies

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

Troubleshooting

  • Ensure the Base URL is correctly set to your Twenty workspace REST API endpoint including the /rest suffix.
  • Verify that the API key credential is valid and has sufficient permissions to create person records.
  • Check that required fields (First Name, Last Name, Primary Email) are provided and correctly formatted.
  • If SSL issues occur, consider enabling the option to ignore SSL certificate validation, but be aware of security risks.
  • When using batching, ensure batch size and interval are configured to avoid rate limiting or timeouts.

Links

  • Twenty API Documentation - Official API documentation for the Twenty platform, useful for understanding available endpoints and data structures.

Discussion