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. String 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"
}
Caution

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. String FALSE
Address Line 2 Optional second line for the address. String FALSE
Alternate Emails Additional emails associated with the contact. String FALSE
City City of the contact. String FALSE
Country Country of the contact's address. Accepts full name or abbreviation. String FALSE
Email Primary email for the contact. String TRUE
First Name Contact's personal name. String FALSE
Last Name Contact's family name. String FALSE
Postal Code Postcode, post code, Eircode, PIN code or ZIP code. String FALSE
State Province Region State, province, or region of the contacts address. String FALSE
Phone Number Primary phone number for the contact. String FALSE
Whatsapp Whatsapp account for the contact. String FALSE
Line Landline for the contact. String FALSE
Facebook Primary Facebook profile for the contact. String FALSE
Unique Name Unique name assigned to the contact. String 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. String
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

Elements of Workflows

SendGrid API Reference