Home > Application Reference > Google Contacts > Read All Contacts

Using this action will return every contact within your Google Contact Directory. The key is that the entire output will be a list that will need to be processed likely using Object and/or List functions. Some of the more detailed ones are described below. A couple key actions that can often be used to help get to the contacts you intend to deal with immediately are Filter and For Each.

Output Fields

Note: Many of these fields are often unavailable and get assigned a null/empty value. Contacts (list of text and objects)

  • Contact ID (text): The unique ID for the contact that you intend to read and get information from.
  • Title (text): If a title, such as “Mr.”
  • Subject (text): The subject for the contact.
  • Updated At (text): The date and time the contact that was added or updated.
  • Full Name (text): The full name, including title, of the contact.
  • Family Name (text): The last name of the contact.
  • Given Name (text): The first name.
  • Gender (text): The gender.
  • Occupation (text): The occupation.
  • Billing Information (text): The billing information.
  • Directory Server (text): The directory server associated with the contact.
  • Birthday (text): The contact’s birthday in the format yyyy-mm-dd (e.g. “1999-08-15”)
  • Nickname (text): The contact’s nickname.
  • Extended Properties (object): An object with keys and values for each custom property added for the contact. Use the Object functions such as Get or Get Multiple to access individual values.

NOTE: The following output fields are lists of objects since a Google Contact may have, for example, many phone numbers, emails, websites, etc. The List Functions can help your process a list, e.g. you can use a At card to choose the first phone number in the list or a Filter card to pick out the phone number where the Primary? field is set to True.

  • Phone Numbers (list of object): The list of phone numbers for the contact, where each phone number is an object with the following fields:
    • Phone Number (text)
    • Label (text): if a custom type is provided, it appears here and Type is empty
    • Type (text): type of phone number, e.g. “HOME” or “MOBILE”
    • Primary? (true/false): indicates if this is marked as the primary number to use
  • Email Addresses (list of object): The list of email addresses, where each email has the following fields:
    • Email Address (text)
    • Display Name (text)
    • Label (text): if a custom type is provided, it appears here and Type is empty
    • Type (text): type of email address, e.g. “HOME” or “WORK”
    • Primary? (true/false): indicates if this is marked as the primary email to use
  • Postal Addresses (list of object): The list of mailing addresses, where each address has the following fields:
    • Street (text)
    • City (text)
    • Region (text)
    • Neighborhood (text)
    • Postal Code (text)
    • PO Box (text)
    • Country (text)
    • Type (text): type of address, e.g. “HOME” or “WORK”
    • Label (text): if a custom type is provided, it appears here and Type is empty
    • Primary? (true/false):  indicates if this is marked as the primary address to use
  • Organizations (list of object): The list of companies or organizations the contact is associated with, where each organization has the following fields:
    • Organization Name (text)
    • Job Title (text)
    • Job Description (text)
    • Department (text)
    • Label (text)
  • Websites (list of object): The list of websites for the contact where each has the following fields:
    • Primary? (true/false):  indicates if this is marked as the primary website for the contact
    • Link (text): URL to the website
    • Label (text)
  • Languages (list of object): The list of languages associated with the contact where each has the following fields:
    • Language Code (text): language code that conforms to IETF BCP 47.
    • Label (text)
  • External IDs (list of object): The list of IDs for the contact in an external system where each has:
    • Value (text): the ID
    • Label (text)
    • Type (text)
  • Calendars (list of object): The list of calendars for the contact, where each has the following fields:
    • Calendar Link (text):
    • Label (text): if a custom type is provided, it appears here and Type is empty
    • Type (text): type of email address, e.g. “HOME” or “WORK”
    • Primary? (true/false): indicates if this is marked as the primary email to use
  • Context
    • Execution ID (text): The execution ID of the Flow that ran for this contact. Can be used for error handling purposes.