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      -   US Department of Defense (DoD)
Power Automate	Standard	All Power Automate regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Standard	All Power Apps regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	Microsoft
URL	Microsoft LogicApps Support Microsoft Power Automate Support Microsoft Power Apps Support

Connector Metadata
Publisher	Microsoft
Website	https://contacts.google.com/
Privacy policy	https://policies.google.com/privacy

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.

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.

Important

Starting from June 15, 2021 some actions will start to fail due to Google deprecating the endpoints these actions are using. To know about it more, please see the following post from Google: https://developers.google.com/contacts/v3/announcement.

The following actions are affected:

Create a contact; Get my contacts; Get my contacts V2; and When a contact changes.

To avoid interruptions use the following actions:

Create a contact V2; Get my contacts V4; and When a contact changes V3.

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Create a contact [DEPRECATED]	This action has been deprecated. Please use Create a contact V3 instead. Create a contact within Google Contacts
Create a contact V2	Create a contact within Google Contacts V2
Create a contact V3 (Preview)	Create a contact within Google Contacts V3
Get my contacts [DEPRECATED]	This action has been deprecated. Please use Get my contacts V4 instead. Get my contacts.
Get my contacts V2 [DEPRECATED]	This action has been deprecated. Please use Get my contacts V4 instead. Get my contacts V2.
Get my contacts V3 [DEPRECATED]	This action has been deprecated. Please use Get my contacts V4 instead. Get my contacts V3.
Get my contacts V4	Get my contacts V4.

Create a contact [DEPRECATED]

Operation ID:

CreateContact

This action has been deprecated. Please use Create a contact V3 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
Group	group		string	Group to add the contact to.
Company	company		string
Work Phone Number	workPhoneNumber		string
Mobile Phone Number	mobilePhoneNumber		string
Home Email Address	homeEmail		string	Home Email address for the contact.
Other Email Address	otherEmail		string
Nickname	nickName		string
Home Address	homeAddress		string
Work Address	workAddress		string
Other Address	otherAddress		string
Job Title	jobTitle		string
Home Phone Number	homePhoneNumber		string
Other Phone Number	otherPhoneNumber		string
Notes	notes		string

Returns

Name	Path	Type	Description
entry	entry	Entry

Create a contact V2

Operation ID:

PeopleApiCreateContactV2

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
Group	group		string	Group to add the contact to.
Company	company		string
Work Phone Number	workPhoneNumber		string
Mobile Phone Number	mobilePhoneNumber		string
Home Email Address	homeEmail		string	Home Email address for the contact.
Other Email Address	otherEmail		string
Nickname	nickName		string
Home Address	homeAddress		string
Work Address	workAddress		string
Other Address	otherAddress		string
Job Title	jobTitle		string
Home Phone Number	homePhoneNumber		string
Other Phone Number	otherPhoneNumber		string

Returns

Body

PeopleApiConnection

Create a contact V3 (Preview)

Operation ID:

PeopleApiCreateContactV3

Create a contact within Google Contacts V3

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
Group	group		string	Group to add the contact to.
Company	company		string
Work Phone Number	workPhoneNumber		string
Mobile Phone Number	mobilePhoneNumber		string
Home Email Address	homeEmail		string	Home Email address for the contact.
Other Email Address	otherEmail		string
Nickname	nickName		string
Home Address	homeAddress		string
Work Address	workAddress		string
Other Address	otherAddress		string
Job Title	jobTitle		string
Home Phone Number	homePhoneNumber		string
Other Phone Number	otherPhoneNumber		string

Returns

Body

PeopleApiConnectionV2

Get my contacts [DEPRECATED]

Operation ID:

ListContacts

This action has been deprecated. Please use Get my contacts V4 instead.

Get my contacts.

Returns

Name	Path	Type	Description
Contact	feed.entry	array of Entry

Get my contacts V2 [DEPRECATED]

Operation ID:

ListContactsV2

This action has been deprecated. Please use Get my contacts V4 instead.

Get my contacts V2.

Returns

Name	Path	Type	Description
Contact	value	array of Entry

Get my contacts V3 [DEPRECATED]

Operation ID:

PeopleApiListContactsV3

This action has been deprecated. Please use Get my contacts V4 instead.

Get my contacts V3.

Returns

Name	Path	Type	Description
connections	connections	array of PeopleApiConnection

Get my contacts V4

Operation ID:

PeopleApiListContactsV4

Get my contacts V4.

Returns

Name	Path	Type	Description
connections	connections	array of PeopleApiConnectionV2

Triggers

When a contact changes [DEPRECATED]	When a contact changes in Google Contacts.
When a contact changes V2 [DEPRECATED]	This action has been deprecated. Please use When a contact changes V3 instead. When a contact changes in Google Contacts V2.
When a contact changes V3	When a contact changes in Google Contacts V3.

When a contact changes [DEPRECATED]

Operation ID:

OnContactUpdated

When a contact changes in Google Contacts.

Returns

Name	Path	Type	Description
entry	feed.entry	array of Entry

When a contact changes V2 [DEPRECATED]

Operation ID:

PeopleApiOnContactUpdatedV2

This action has been deprecated. Please use When a contact changes V3 instead.

When a contact changes in Google Contacts V2.

Returns

Name	Path	Type	Description
connections	connections	array of PeopleApiConnection

When a contact changes V3

Operation ID:

PeopleApiOnContactUpdatedV3

When a contact changes in Google Contacts V3.

Returns

Name	Path	Type	Description
connections	connections	array of PeopleApiConnectionV2

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.

PeopleApiConnectionV2

Name	Path	Type	Description
Id	metadata.source.id	string	The id of the contact.
Updated DateTime	metadata.source.updateTime	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.
addresses	addresses	array of object
Address	addresses.formattedValue	string	The address of the contact.
emailAddresses	emailAddresses	array of object
Email	emailAddresses.value	string	The email address of the contact.
Type	emailAddresses.formattedType	string	The type of email address of the contact.
phoneNumbers	phoneNumbers	array of object
Phone Number	phoneNumbers.value	string	The phone number of the contact.
Type	phoneNumbers.formattedType	string	The phone number of the contact.