Load contact

Load GMail contacts

Load one contact when running a batch, otherwise the given contact

query
photo
contactId
title
...

Load dedicated contacts from your GMail address book, the address book of the user running your app or any other user that has granted access to their contacts.

You can either manually select a single or multiple contacts or load a contact by a given query or ID.

If you have enabled user input you can also let the user of your app pick the contacts to be loaded

Use cases

  • Generate and send personalized emails or PDF documents to contacts from your Google address book
  • Use the contact data in your mails and documents
  • Print multiple address labels per page by loading multiple contacts

Configuration

Click on the bold text in the title of the building block to open the configuration dialog.

 Edit

Use the edit icon to edit the template in a new browser tab.

When dragging this block into the flow you can either select an existing contact from your GMail address book or you can create a new one.

Click on the bold name(s) of the selected contact(s) to change the selected contact(s).

On the left you can find the input variables of this building block:

Use the query input variable to find the contacts at run-time that matches your provided query string.

Advanced variables

When adding this block to the flow you will find a few selected fields of the contact that will give you simple access to the basic information.

You can access all available contact fields by using the following variables:

Variable

Description

id

Unique ID of the contact

title

Inserts the title of the contact

photo

Inserts the URL of the contact photo

name.fullName

Inserts the full name of the contact

name.givenName

Inserts the given name of the contact

name.familyName

Inserts the family name of the contact

name.namePrefix

Inserts the name prefix of the contact

name.nameSuffix

Inserts the name suffix of the contact

birthday

Inserts the birthday the contact

emailPrimary.address

Inserts the primary email address of the contact

emailPrimary.displayName

Inserts the primary email display name

emailPrimary.rel

Inserts the primary email type of the contact

emailPrimary.label

Inserts the primary email label of the contact

emailAddresses[].address

Inserts the email addresses of the contact

emailAddresses[].displayName

Inserts the email display names

emailAddresses[].rel

Inserts the email types of the contact

emailAddresses[].label

Inserts the email labels of the contact

emailAddresses[].primary

Inserts whether the email addresses are primary or not

emailWork.address

Inserts the work phone number of the contact

emailHome.address

Inserts the home email address of the contact

phonePrimary.number

Inserts the primary phone number of the contact

phonePrimary.rel

Inserts the primary phone type of the contact

phonePrimary.label

Inserts the primary phone label of the contact

phoneNumbers[].number

Inserts the phone numbers of the contact

phoneNumbers[].rel

Inserts the phone types of the contact

phoneNumbers[].label

Inserts the phone labels of the contact

phoneNumbers[].primary

Inserts whether the phone numbers are primary or not

phoneWork.number

Inserts the work phone number of the contact

phoneHome.number

Inserts the home phone number of the contact

phoneMobile.number

Inserts the mobile phone number of the contact

fax.number

Inserts the fax number of the contact

faxWork.number

Inserts the work fax number of the contact

faxHome.number

Inserts the home fax number of the contact

structuredPostalAddresses[].formattedAddress

Inserts the formatted postal addresses

structuredPostalAddresses[].city

Inserts the city of the postal addresses

structuredPostalAddresses[].country

Inserts the country of the postal addresses

structuredPostalAddresses[].countryCode

Inserts the country code of the postal addresses

structuredPostalAddresses[].street

Inserts the street of the postal addresses

structuredPostalAddresses[].postcode

Inserts the postcode of the postal addresses

structuredPostalAddresses[].pobox

Inserts the postbox of the postal addresses

structuredPostalAddresses[].rel

Inserts the type of the postal addresses

structuredPostalAddresses[].label

Inserts the label of the postal addresses

structuredPostalAddresses[].primary

Inserts whether the postal addresses are primary or not

addressPrimary.formattedAddress

Inserts the formatted postal primary address

addressPrimary.city

Inserts the city of the primary address

addressPrimary.country

Inserts the country of the primary address

addressPrimary.countryCode

Inserts the country code of the primary address

addressPrimary.street

Inserts the street of the primary address

addressPrimary.postcode

Inserts the postcode of the primary address

addressPrimary.pobox

Inserts the postbox of the primary address

addressPrimary.rel

Inserts the type of the primary address

addressPrimary.label

Inserts the label of the primary address

addressWork.formattedAddress

Inserts the formatted postal work address

addressWork.city

Inserts the city of the work address

addressWork.country

Inserts the country of the work address

addressWork.countryCode

Inserts the country code of the work address

addressWork.street

Inserts the street of the work address

addressWork.postcode

Inserts the postcode of the work address

addressWork.pobox

Inserts the postbox of the work address

addressWork.rel

Inserts the type of the work address

addressWork.label

Inserts the label of the work address

addressWork.primary

Inserts whether the work address is primary or not

addressHome.formattedAddress

Inserts the formatted postal home address

addressHome.city

Inserts the city of the home address

addressHome.country

Inserts the country of the home address

addressHome.countryCode

Inserts the country code of the home address

addressHome.street

Inserts the street of the home address

addressHome.postcode

Inserts the postcode of the home address

addressHome.pobox

Inserts the postbox of the home address

addressHome.rel

Inserts the type of the home address

addressHome.label

Inserts the label of the home address

addressHome.primary

Inserts whether the home address is primary or not

organizations[].orgTitle

Inserts the organization titles of the contact

organizations[].orgDepartment

Inserts the organization departments of the contact

organizations[].orgName

Inserts the organization names of the contact

organizations[].orgSymbol

Inserts the organization symbols of the contact

organizations[].orgJobDescription

Inserts the organization job descriptions of the contact

organizations.rel

Inserts the type of the organization

organizations.label

Inserts the label of the organization

organizations.primary

Inserts whether the organizations are primary or not

organizationPrimary.orgTitle

Inserts the title of the primary organization

organizationPrimary.orgDepartment

Inserts the department of the primary organization

organizationPrimary.orgName

Inserts the name of the primary organization

organizationPrimary.orgSymbol

Inserts the symbol of the primary organization

organizationPrimary.orgJobDescription

Inserts the job description of the primary organization

organizationPrimary.rel

Inserts the type of the primary organization

organizationPrimary.label

Inserts the label of the primary organization

gender

Inserts the gender of the contact

male

Inserts whether the contact is male

female

Inserts whether contact is female

custom.<yourcustomfield>

Inserts the value of the custom field

Learn more

When printing address labels you'll have to load multiple contacts and use the repeat block to split them up in chunks matching the number of labels you want to print per page.

If you for example want to print 8 address labels per page, select at least 8 contacts to be able to test your template.

Useful combinations

Welcome email to new customers

Load contact

Google Contact
userName
userEmail

Generate Sign up offer HTML

userName
htmlFile

Email to new users

userEmail
HTML EAMIL
htmlFile

Add to "New Customer" group

contactId
CONTACT GROUP

With the Load contact building block newly added Google contacts are loaded. Using the to HTML building block personalized sign-up offers are created by filling the loaded contact information into a html template. The execution happens in a batch jobs and performs all activities for every loaded

The offers are sent to each user's email address.

To better identify users as a new users in Google contacts the contact can (optionally) be added to a dedicated "New Customer" group using the Add to group building block.

Copy App

Imprint with relevant contacts

Load CEO

CEO CONTACT
ceoName
ceoEmail
ceoAddress

Load CFO

CFO CONTACT
cfoName
cfoEmail
cfoAddress

Load CTO

CTO CONTACT
ctoName
ctoEmail
ctoAddress

Generate imprint HTML

CTO CONTACT
ctoName
ceoName
imprintHtml
ceoEmail
ceoAddress
cfoName
cfoEamil
cfoAddress
ctoName
ctoEamil
ctoAddress

Stop and display imprint

imprintHtml
IMPRINT HTML

The imprint of your web page should list relevant contacts of your company. In order to easily load the most current information you may just load the contact information of the relevant people from your Google contacts.

Using the Load contact building block a single contact with its information is loaded. The available information is then used to generate an imprint html based on a imprint template. You can use the html information on your web-page, in this example the html page is displayed after the execution of the Ultradox flow is stopped.

Send an email with directions from customer to your business location

Receive directions request

GOOGLE FORM
customerEmail
customerAddress

Load Company Contact

COMPANY CONTACT
companyAddress

Get directions

customerAddress
directions
customerAddress

Generate directions HTML

directions
directionsHtml

Send directions email

customerEamil
DIRECTIONS EAMIL
directionsHtml

For your business it may be helpful to provide customers with directions to your location. Many web pages show a business location on a Google map but individual customer will need to come up with the directions from their individual location themselves.

This example shows how a customer may enter her/his starting location in a Google from. Once submitted the business address is located from a Google  Of course also for the customer an individual contact can be created allowing you to further process the customer information.

Having access the starting location (customer) and target location (your business) use the Get directions building block to compile the directions. Process the direction information in a html file with can be shown on your web page or emailed to the requesting user.

Copy App

Questions and Feedback

If you have any comments on this page, feel free to add suggestions right to the Google document that we are using to create this site.

If you are not yet member of the Ultradox community on Google+, please join now to get updates from our end or to provide feedback, bug reports or discuss with other users.

Last Updated: 11/30/18