Google Contacts is a cloud-based address book service provided by Google, allowing users to store, manage, and synchronize their contact information across multiple devices and platforms.

Categories: CRM

Type: googleContacts/v1

Connections

Version: 1

OAuth2 Authorization Code

Properties

Name	Label	Type	Description	Required
clientId	Client Id	STRING		true
clientSecret	Client Secret	STRING		true

Actions

Create Contact

Name: createContact

Creates a new contact.

Properties

Name	Label	Type	Description	Required
givenName	First Name	STRING	`The first name of the contact.`	true
middleName	Middle Name	STRING	`The middle name of the contact.`	false
familyName	Last Name	STRING	`The last name of the contact.`	true
title	Job Title	STRING	`The job title of the contact.`	false
name	Company	STRING	`The company of the contact.`	false
email	Email	STRING	`The email addresses of the contact.`	false
phoneNumber	Phone Number	STRING	`The phone numbers of the contact.`	false

Example JSON Structure

{
  "label" : "Create Contact",
  "name" : "createContact",
  "parameters" : {
    "givenName" : "",
    "middleName" : "",
    "familyName" : "",
    "title" : "",
    "name" : "",
    "email" : "",
    "phoneNumber" : ""
  },
  "type" : "googleContacts/v1/createContact"
}

Output

Type: OBJECT

Properties

Name	Type	Description
names	ARRAY Items [{STRING(familyName), STRING(givenName), STRING(middleName)}]	The person's names.
organizations	ARRAY Items [{STRING(name), STRING(title)}]	The person's past or current organizations.
emailAddresses	ARRAY Items [{STRING(value)}]	The person's email addresses.
phoneNumbers	ARRAY Items [{STRING(value)}]	The person's phone numbers.

Output Example

{
  "names" : [ {
    "familyName" : "",
    "givenName" : "",
    "middleName" : ""
  } ],
  "organizations" : [ {
    "name" : "",
    "title" : ""
  } ],
  "emailAddresses" : [ {
    "value" : ""
  } ],
  "phoneNumbers" : [ {
    "value" : ""
  } ]
}

Create Group

Name: createGroup

Creates a new group.

Properties

Name	Label	Type	Description	Required
name	Group Name	STRING	`The name of the group.`	true

Example JSON Structure

{
  "label" : "Create Group",
  "name" : "createGroup",
  "parameters" : {
    "name" : ""
  },
  "type" : "googleContacts/v1/createGroup"
}

Output

Type: OBJECT

Properties

Name	Type	Description
name	STRING	The contact group name set by the group owner or a system provided name for system groups.

Output Example

{
  "name" : ""
}

Update Contact

Name: updateContact

Modifies an existing contact.

Properties

Name	Label	Type	Description	Required
resourceName	Resource Name	STRING	`Resource name of the contact to be updated.`	true
givenName	First Name	STRING	`New first name of the contact.`	true
middleName	Middle Name	STRING	`New middle name of the contact.`	false
familyName	Last Name	STRING	`Updated last name of the contact.`	true
title	Job Title	STRING	`Updated job title of the contact.`	false
name	Company	STRING	`Updated name of the company where the contact is employed.`	false
email	Email Address	STRING	`Updated email address of the contact.`	false
phoneNumber	Phone Number	STRING	`Updated phone number of the contact.`	false

Example JSON Structure

{
  "label" : "Update Contact",
  "name" : "updateContact",
  "parameters" : {
    "resourceName" : "",
    "givenName" : "",
    "middleName" : "",
    "familyName" : "",
    "title" : "",
    "name" : "",
    "email" : "",
    "phoneNumber" : ""
  },
  "type" : "googleContacts/v1/updateContact"
}

Output

Type: OBJECT

Properties

Name	Type	Description
names	ARRAY Items [{STRING(familyName), STRING(givenName), STRING(middleName)}]	The person's names.
organizations	ARRAY Items [{STRING(name), STRING(title)}]	The person's past or current organizations.
emailAddresses	ARRAY Items [{STRING(value)}]	The person's email addresses.
phoneNumbers	ARRAY Items [{STRING(value)}]	The person's phone numbers.

Output Example

{
  "names" : [ {
    "familyName" : "",
    "givenName" : "",
    "middleName" : ""
  } ],
  "organizations" : [ {
    "name" : "",
    "title" : ""
  } ],
  "emailAddresses" : [ {
    "value" : ""
  } ],
  "phoneNumbers" : [ {
    "value" : ""
  } ]
}

Search Contacts

Name: searchContacts

Searches the contacts in Google Contacts account.

Properties

Name	Label	Type	Description	Required
query	Query	STRING	`The plain-text query for the request.The query is used to match prefix phrases of the fields on a person. For example, a person with name "foo name" matches queries such as "f", "fo", "foo", "foo n", "nam", etc., but not "oo n".`	true
readMask	Read Mask	ARRAY Items [STRING]	`A field mask to restrict which fields on each person are returned.`	true
pageSize	Page Size	INTEGER	`The number of results to return per page.`	true

Example JSON Structure

{
  "label" : "Search Contacts",
  "name" : "searchContacts",
  "parameters" : {
    "query" : "",
    "readMask" : [ "" ],
    "pageSize" : 1
  },
  "type" : "googleContacts/v1/searchContacts"
}

Output

Type: ARRAY

Items Type: OBJECT

Properties

Name	Type	Description
names	ARRAY Items [{STRING(familyName), STRING(givenName), STRING(middleName)}]	The person's names.
organizations	ARRAY Items [{STRING(name), STRING(title)}]	The person's past or current organizations.
emailAddresses	ARRAY Items [{STRING(value)}]	The person's email addresses.
phoneNumbers	ARRAY Items [{STRING(value)}]	The person's phone numbers.

Output Example

[ {
  "names" : [ {
    "familyName" : "",
    "givenName" : "",
    "middleName" : ""
  } ],
  "organizations" : [ {
    "name" : "",
    "title" : ""
  } ],
  "emailAddresses" : [ {
    "value" : ""
  } ],
  "phoneNumbers" : [ {
    "value" : ""
  } ]
} ]

Additional instructions

CONNECTION

Setting up OAuth2

Turning on Contacts API

Google Contacts

On this page