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

Related topics

SendGrid connector

Workflow elements

SendGrid API Reference