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 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 V2 [DEPRECATED] |
This action has been deprecated. Please use Get my contacts V4 instead.
|
| Get my contacts V3 [DEPRECATED] |
This action has been deprecated. Please use Get my contacts V4 instead.
|
| Get my contacts V4 |
Get my contacts V4. |
Create a contact [DEPRECATED]
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
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)
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
Get my contacts [DEPRECATED]
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]
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]
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
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 V3 |
When a contact changes in Google Contacts V3. |
When a contact changes [DEPRECATED]
When a contact changes in Google Contacts.
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
entry
|
feed.entry | array of Entry |
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.
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
connections
|
connections | array of PeopleApiConnection |
When a contact changes V3
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. |