Twenty CRMInstall

Summary

Create a new person record in Twenty CRM by providing mandatory first and last names along with optional details such as avatar URL, city, associated company, email, job title, LinkedIn URL, phone number, and any number of custom fields.

Inputs

• firstName (required) — The first name of the person to create.
• lastName (required) — The last name of the person to create.
• additionalFields — Optional additional fields including avatar URL, city, associated company, email, job title, LinkedIn URL, and phone number.
• customFieldsUi — Optional custom fields where you can specify the API field name and value to include additional data beyond standard fields.

Output shape

a single record representing the created person, including the standard and any custom fields set.

The output contains the API response with all person details as stored in Twenty CRM after creation. Errors and API-specific responses are not detailed here.

Examples

Example 1: Create a new person with first and last names only

firstName='Jane', lastName='Doe' with no additional or custom fields

Example 2: Create a new person with additional email and phone

firstName='John', lastName='Smith', additionalFields.email='john.smith@example.com', additionalFields.phone='+1234567890'

Example 3: Create a new person including custom fields

firstName='Alice', lastName='Johnson', customFieldsUi includes custom field 'favoriteColor' with value 'blue'

Links

• n8n community nodes installation guide