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