Twenty CRM icon

Twenty CRM

Interact with Twenty CRM - Open Source CRM

Custom Object → Create

AI-generated

Summary

Create a new record in a specified custom object in Twenty CRM by providing the object's API name and the fields as a JSON object. Optionally specify the depth of relational data to include in the response, with a maximum depth of 2.

Inputs

  • Object API Name (required) — The API name of the custom object (plural form) to create the record in, e.g., 'customLeads' or 'myCustomObject'.
  • Fields (JSON) (required) — A JSON object containing field names and corresponding values for the new record; field names must match the API field names defined in your Twenty CRM custom object.
  • Options - Depth — Numeric value (0-2) indicating the depth of related objects to include in the response; defaults to 1.

Output shape

a JSON object representing the newly created custom object record, including its fields and optionally nested related data depending on depth option.

The output's structure will reflect the created record returned by Twenty CRM API and may include nested relational data up to the specified depth level. The operation returns an error if required inputs are missing or invalid.

Links

Discussion