SendGrid - Search contacts

Use the SendGrid - Search contacts action A tool for building the processes, logic, and direction within workflows. Actions are the steps the workflow performs to complete a process. to search for contacts and retrieve their details.

  • The action retrieves a maximum of 50 contacts.
  • A 408 Request Timeout message is returned if the query takes longer than 20 seconds.

Use Segmentation Query Language (SGQL) to refine your search query.

Before you begin: 

Jump to:

Configure the SendGrid - Search contacts action

  1. Add the action to the workflow and open the action configuration panel. For more information, see Add an action to the workflow.

  2. Select a Connection. If you do not have a connection, see Add a connection. See the SendGrid connector page for details on creating a SendGrid connector.
  3. Enter a search query. Use Segmentation Query Language (SGQL) to refine your search query.

SendGrid - Search contacts action fields and settings

Section Field Description Variable types

(unlabeled)

Connection Credentials and other settings that enables workflows to communicate with external systems, services, or applications. It's required to pass data between the workflow and the indicated service, which could be a cloud service, business application, or content store.

The SendGrid connection used to access the account for which you want to retrieve the contact details.

To refresh the available connections, click .

 (n/a)
  Search Use Segmentation Query Language (SGQL) to refine your search query. For example: email LIKE '%gmail.com' Text, Decimal, Integer, Boolean, DateTime, Collection

Output

Contacts

Variable to store the returned contacts as an object for use later in the workflow.

  • Contact count: (Integer) Total number of returned contacts.
  • Contacts: (Collection) A collection of the contacts details.

    • ID: (Text) Unique ID for the contact.

    • First name: (Text) The contact's first name.

    • Last name: (Text) The contact's last name.

    • Email: (Text) The contact's email address.

    • Address 1: (Text) The contact's physical address line 1, for example 234 Church street.

    • Address 2: (Text) The contact's physical address line 2.

    • City: (Text) Which city the contact's address is in.

    • State/province code: (Text) The code or name of the state or province for the contacts address.

    • ZIP/postal code: (Text) The contact's ZIP or postal code.

    • Country: (Country) The contact's country.

    • Phone number: (Text) The contact's phone number.

    • Created: (Date) The date the contact was created.

    • Modified: (Date) The date the contact's details was last modified.

    • Lists (Collection) A collection of list IDs that show what lists the contact is part of.

      • ID (Text) The ID for the list that the contact is part of.