Close menu
Explore Plans
Mobile menu Close menu
SendGrid

Find a contact by email

Pro plus icon This query returns the details of the marketing contact with the email address you specify.

Developer info

API endpoint slug
sendgrid.find_contact_by_email
Runtime method
performQuery("sendgrid.find_contact_by_email"}

Query fields

Email address Text input > Other

Label
Email address
Helper text
The contact's email address. Matching is exact (case-insensitive).
Slug
email_address
Required
true
Can have default value
true

Ingredients

Contact The SendGrid ID of the matched contact.

Slug
contact_id
Filter code
Sendgrid.findContactByEmail.ContactId
Type
String
Example
47ef9e3a-1c0b-4b6b-9c0a-12345678abcd

Contact first name The contact's first name.

Slug
contact_first_name
Filter code
Sendgrid.findContactByEmail.ContactFirstName
Type
String
Example
Alex

Contact last name The contact's last name.

Slug
contact_last_name
Filter code
Sendgrid.findContactByEmail.ContactLastName
Type
String
Example
Rivera

Contact email The contact's email address as stored in SendGrid.

Slug
contact_email
Filter code
Sendgrid.findContactByEmail.ContactEmail
Type
String
Example
alex@example.com

List ids The IDs of the lists the contact belongs to, separated by commas.

Slug
list_ids
Filter code
Sendgrid.findContactByEmail.ListIds
Type
String
Example
a1b2c3d4-0000-1111-2222-333344445555