Create Contact

Create a new contact in SendGrid.

Options

Field	Definition	Type	Required
Contact Set	Choose whether to create a single contact or a list of contacts; options are Single Contact or List of Contacts.	Dropdown	TRUE

Input

Field	Definition	Type	Required
List
List IDs	Unique identifiers of lists to which the new contact will be added.	Text	FALSE
Contact (List of Contacts)
Contacts	Full contact profile for each of the new contacts as a JSON object. Example: Copy `{ "first_name": "John", "state_province_region": "CA", "address_line_2": "", "last_name": "Smith", "alternate_emails": "jsmith@othercompany.com", "city": "Los Angeles", "address_line_1": "123 Joy Street", "postal_code": 92320, "country": "USA", "email": "john.smith@company.com" }` Due to SendGrid API limitations, you can add a maximum of 30,000 contacts.	List of Objects	FALSE
Contact (Single Contact)
Address Line 1	First line of the address.	Text	FALSE
Address Line 2	Optional second line for the address.	Text	FALSE
Alternate Emails	Additional emails associated with the contact.	Text	FALSE
City	City of the contact.	Text	FALSE
Country	Country of the contact's address. Accepts full name or abbreviation.	Text	FALSE
Email	Primary email for the contact.	Text	TRUE
First Name	Contact's personal name.	Text	FALSE
Last Name	Contact's family name.	Text	FALSE
Postal Code	Postcode, post code, Eircode, PIN code or ZIP code.	Text	FALSE
State Province Region	State, province, or region of the contacts address.	Text	FALSE
Phone Number	Primary phone number for the contact.	Text	FALSE
Whatsapp	Whatsapp account for the contact.	Text	FALSE
Line	Landline for the contact.	Text	FALSE
Facebook	Primary Facebook profile for the contact.	Text	FALSE
Unique Name	Unique name assigned to the contact.	Text	FALSE
Custom Fields	Custom fields created for the contact in SendGrid.	Various	FALSE

Output

Field	Definition	Type
Job
Job ID	Unique identifier of the async job to create the contact or contacts.	Text
Status Code	Result of the operation. The connector returns an HTTP status code that indicates whether the action taken by the card succeeded or failed. For example: A 201 Created status code indicates success where a new resource was created. A 403 Forbidden error indicates that the HTTP request wasn't processed because the necessary permissions were missing. For a full list of possible status codes, see HTTP status codes.	Number

Field

Definition

Type

Job

Job ID

Unique identifier of the async job to create the contact or contacts.

Text

Status Code

Result of the operation. The connector returns an HTTP status code that indicates whether the action taken by the card succeeded or failed. For example:

A 201 Created status code indicates success where a new resource was created.
A 403 Forbidden error indicates that the HTTP request wasn't processed because the necessary permissions were missing.

For a full list of possible status codes, see HTTP status codes.

Number

Create Contact

Options

Input

Output

Related topics