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