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
![]() 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 |
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 account for the contact. | String | FALSE | |
Line | Landline for the contact. | String | FALSE |
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:
For a full list of possible status codes, see HTTP status codes. |
Number |