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"
}

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"
}

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"
}

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"
}

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" : ""
  } ]
} ]

What to do if your action is not listed here?

If this component doesn't have the action you need, you can use Custom Action to create your own. Custom Actions empower you to define HTTP requests tailored to your specific requirements, allowing for greater flexibility in integrating with external services or APIs.

To create a Custom Action, simply specify the desired HTTP method, path, and any necessary parameters. This way, you can extend the functionality of your component beyond the predefined actions, ensuring that you can meet all your integration needs effectively.

Additional Instructions

Connection Setup

Setting up OAuth2

Turning on Contacts API

Google Contacts

On this page