Actions12
Contact → Create
AI-generatedSummary
Create a new contact in Loops by specifying the required email address and optionally including additional fields and custom properties to define the contact's details.
Inputs
- Email (required) — Email address of the contact.
- Additional Fields — Optional additional details for the contact, such as first name, last name, mailing lists (as a JSON object mapping list IDs to boolean), source of acquisition, subscription status, user group, and user ID.
- Custom Properties — Optional key-value pairs of custom properties to associate with the contact.
Output shape
a single JSON object representing the created contact with its details as returned by the Loops API.
If the creation request succeeds, the response contains the contact information as a JSON object. Errors during creation will throw exceptions unless 'continue on fail' is enabled, in which case errors are returned per item.
Examples
Example 1: Create a basic contact using just an email
Specify the 'Email' parameter with a valid email address.
Example 2: Create a contact with additional information and custom properties
Provide 'Email', fill fields under 'Additional Fields' like firstName and mailingLists, and add key-value pairs under 'Custom Properties'.