Google Contacts

Google Contacts is an online address book, integrated across your Google products and more.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
Flow Standard All Flow regions except the following:
     -   US Government (GCC)
PowerApps Standard All PowerApps regions except the following:
     -   US Government (GCC)

To use this integration, you will need a Google account. If you are not a user yet, sign up for a new account. When trying to make a connection, you will be prompted to authenticate against your account. If you have multiple accounts, pick the one you would like to use and Sign in. Once verified, you will need to authorize Microsoft to access your contacts. Click on Allow to continue.

Image 1

You're now ready to start using this integration.

Known issues and limitations

Action "Get my contacts" currently does not support pagination. It returns 1024 contacts maximum. If you have more contacts, only first 1024 will be returned back by the action.

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds

Actions

Create a contact [DEPRECATED]

This action has been deprecated. Please use Create a contact V2 instead.

Create a contact within Google Contacts

Create a contact V2

Create a contact within Google Contacts V2

Get my contacts

Get my contacts.

Get my contacts V2

Get my contacts V2.

Get my contacts V3

Get my contacts V3.

Create a contact [DEPRECATED]

This action has been deprecated. Please use Create a contact V2 instead.

Create a contact within Google Contacts

Parameters

Name Key Required Type Description
Display Name
displayName True string

Display name for the contact.

Work Email Address
workEmail string

Display name for the contact.

Group
group string

Group to add the contact to.

Company
company string

Display name for the contact.

Work Phone Number
workPhoneNumber string

Display name for the contact.

Mobile Phone Number
mobilePhoneNumber string

Display name for the contact.

Home Email Address
homeEmail string

Home Email address for the contact.

Other Email Address
otherEmail string

Display name for the contact.

Nickname
nickName string

Display name for the contact.

Home Address
homeAddress string

Display name for the contact.

Work Address
workAddress string

Display name for the contact.

Other Address
otherAddress string

Display name for the contact.

Job Title
jobTitle string

Display name for the contact.

Home Phone Number
homePhoneNumber string

Display name for the contact.

Other Phone Number
otherPhoneNumber string

Display name for the contact.

Notes
notes string

Display name for the contact.

Returns

Name Path Type Description
entry
entry Entry

Create a contact V2

Create a contact within Google Contacts V2

Parameters

Name Key Required Type Description
Given Name
givenName True string

Given name for the contact.

Family Name
familyName string

Family name for the contact.

Work Email Address
workEmail string

Given name for the contact.

Group
group string

Group to add the contact to. Some groups don't allow adding contacts. These special groups include: Blocked, All Contacts and Chat Contacts

Company
company string

Given name for the contact.

Work Phone Number
workPhoneNumber string

Given name for the contact.

Mobile Phone Number
mobilePhoneNumber string

Given name for the contact.

Home Email Address
homeEmail string

Home Email address for the contact.

Other Email Address
otherEmail string

Given name for the contact.

Nickname
nickName string

Given name for the contact.

Home Address
homeAddress string

Given name for the contact.

Work Address
workAddress string

Given name for the contact.

Other Address
otherAddress string

Given name for the contact.

Job Title
jobTitle string

Given name for the contact.

Home Phone Number
homePhoneNumber string

Given name for the contact.

Other Phone Number
otherPhoneNumber string

Given name for the contact.

Returns

Get my contacts

Get my contacts.

Returns

Name Path Type Description
Contact
feed.entry array of Entry

Get my contacts V2

Get my contacts V2.

Returns

Name Path Type Description
Contact
value array of Entry

Get my contacts V3

Get my contacts V3.

Returns

Name Path Type Description
connections
connections array of PeopleApiConnection

Triggers

When a contact changes

When a contact changes in Google Contacts.

When a contact changes V2

When a contact changes in Google Contacts V2.

When a contact changes

When a contact changes in Google Contacts.

Returns

Name Path Type Description
entry
feed.entry array of Entry

When a contact changes V2

When a contact changes in Google Contacts V2.

Returns

Name Path Type Description
connections
connections array of PeopleApiConnection

Definitions

Entry

Name Path Type Description
Id
id.$t string

The id of the contact.

Updated DateTime
updated.$t date-time

The datetime the contact was last updated, in yyyy-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:59.000Z).

Title
title.$t string

The job title of the contact.

Full Name
gd$name.gd$fullName.$t string

The full name of the contact.

Given Name
gd$name.gd$givenName.$t string

The given name of the contact.

Last Name
gd$name.gd$familyName.$t string

The family name of the contact.

Nickname
gContact$nickname.$t string

The nickname of the contact.

gd$organization
gd$organization array of object
Name
gd$organization.gd$orgName.$t string

The origanization name.

Title
gd$organization.gd$orgTitle.$t string

The organization title.

Work Email
workEmail string

The work email address of the contact.

Home Email
homeEmail string

The home address of the contact.

Other Email
otherEmail string

The other address of the contact.

Work Phone Number
workPhoneNumber string

The work phone number of the contact.

Home Phone Number
homePhoneNumber string

The home phone number of the contact.

Other Phone Number
otherPhoneNumber string

The other phone number of the contact.

Mobile Phone Number
mobilePhoneNumber string

The mobile phone number of the contact.

Work Address
workAddress string

The work address of the contact.

Home Address
homeAddress string

The home address of the contact.

Other Address
otherAddress string

The other address of the contact.

PeopleApiConnection

Name Path Type Description
Id
metadata.source.id string

The id of the contact.

Updated DateTime
metadata.source.updatedTime date-time

The datetime the contact was last updated, in yyyy-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:59.000Z).

Full Name
name.displayName string

The full name of the contact.

Given Name
name.givenName string

The given name of the contact.

Family Name
name.familyName string

The family name of the contact.

Nickname
nickname.value string

The nickname of the contact.

organizations
organizations array of object
Name
organizations.name string

The origanization name.

Title
organizations.title string

The organization title.

Work Address
addressesObject.work.formattedValue string

The work address of the contact.

Home Address
addressesObject.home.formattedValue string

The home address of the contact.

Other Address
addressesObject.other.formattedValue string

The other address of the contact.

Work Email
emailAddressesObject.work.value string

The work email address of the contact.

Home Email
emailAddressesObject.home.value string

The home email address of the contact.

Other Email
emailAddressesObject.other.value string

The other email address of the contact.

Work Phone Number
phoneNumbersObject.work.value string

The work phone number of the contact.

Home Phone Number
phoneNumbersObject.home.value string

The home phone number of the contact.

Mobile Phone Number
phoneNumbersObject.mobile.value string

The mobile phone number of the contact.

Other Phone Number
phoneNumbersObject.other.value string

The other phone number of the contact.