Actions26
- Channels Actions
- Closing Notes Actions
- Comments Actions
- Contacts Actions
- Contact Fields Actions
- Conversations Actions
- Lifecycle Actions
- Messages Actions
- User Actions
- Tags Actions
Contacts → Create a Contact
AI-generatedSummary
Create a new contact in Respond.io by specifying an identifier type (email or phone), the contact's identifier, first name, and optional details such as last name, email, phone, preferred language, profile picture URL, country, and custom fields.
Inputs
- Identifier Type (required) — Choose the type of identifier to locate the contact: 'email' or 'phone'.
- Contact Identifier (required) — The email address or phone number of the contact, depending on the chosen identifier type.
- Contact's First Name (required) — The first name of the contact.
- Contact's Last Name — The last name of the contact.
- Contact's Email Address — The contact's email address, required if the identifier type is 'phone'.
- Contact's Phone Number — The contact's phone number, required if the identifier type is 'email'.
- Contact's Preferred Language — The preferred language of the contact selected from a predefined list.
- Contact's Profile Picture URL — URL of the contact's profile picture.
- Contact's Country — Country of the contact selected from a predefined country list.
- Custom Fields — Additional custom fields to set on the contact, supporting various field types and multi-key matching.
Output shape
a single JSON object representing the newly created contact, including its ID and properties.
The output includes all standard and custom fields of the created contact. The operation requires at least the identifier type, the contact's identifier, and first name. Optional fields can be provided to enrich the contact profile. If identifierType "id" is selected, 'Contact ID' is required instead of identifier.
Examples
Example 1: Create contact using email as identifier
Set Identifier Type to 'email', provide Contact Identifier with an email address, input first name (required), and optionally last name, phone, language, country, profile picture, and custom fields.
Example 2: Create contact using phone as identifier
Set Identifier Type to 'phone', provide Contact Identifier with a phone number, input first name (required), and optionally last name, email, language, country, profile picture, and custom fields.