Skip to content
Try for free
On this page

Integrations

Google Contacts

Manage Google Contacts

Google Contacts stores contact records for a Google account. Search or list contacts to obtain their resource names, then use those names to read, update, or delete records. Create contacts with the name, email, phone, and other fields needed by your workflow.

OAuth scopes

Sim requests these scopes when someone connects a Google Contacts account. For a self-hosted deployment, register your own app with the provider using the settings below. See Integrations and OAuth for setup.

SettingValue
Redirect URI<NEXT_PUBLIC_APP_URL>/api/auth/oauth2/callback/google-contacts
Environment variablesGOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET
ScopeDescription
https://www.googleapis.com/auth/userinfo.emailView email address
https://www.googleapis.com/auth/userinfo.profileView basic profile info
https://www.googleapis.com/auth/contactsView and manage Google Contacts

Use the block

Create, read, update, delete, list, and search contacts.

Actions

Google Contacts Create

Create a new contact in Google Contacts

Input

ParameterTypeRequiredDescription
givenNamestringYesFirst name of the contact
familyNamestringNoLast name of the contact
emailstringNoEmail address of the contact
emailTypestringNoEmail type: home, work, or other
phonestringNoPhone number of the contact
phoneTypestringNoPhone type: mobile, home, work, or other
organizationstringNoOrganization/company name
jobTitlestringNoJob title at the organization
notesstringNoNotes or biography for the contact

Output

ParameterTypeDescription
contentstringContact creation confirmation message
metadatajsonCreated contact metadata including resource name and details

Google Contacts Get

Get a specific contact from Google Contacts

Input

ParameterTypeRequiredDescription
resourceNamestringYesResource name of the contact (e.g., people/c1234567890)

Output

ParameterTypeDescription
contentstringContact retrieval confirmation message
metadatajsonContact details including name, email, phone, and organization

Google Contacts List

List contacts from Google Contacts

Input

ParameterTypeRequiredDescription
pageSizenumberNoNumber of contacts to return (1-1000, default 100)
pageTokenstringNoPage token from a previous list request for pagination
sortOrderstringNoSort order for contacts

Output

ParameterTypeDescription
contentstringSummary of found contacts count
metadatajsonList of contacts with pagination tokens

Google Contacts Search

Search contacts in Google Contacts by name, email, phone, or organization

Input

ParameterTypeRequiredDescription
querystringYesSearch query to match against contact names, emails, phones, and organizations
pageSizenumberNoNumber of results to return (default 10, max 30)

Output

ParameterTypeDescription
contentstringSummary of search results count
metadatajsonSearch results with matching contacts

Google Contacts Update

Update an existing contact in Google Contacts

Input

ParameterTypeRequiredDescription
resourceNamestringYesResource name of the contact (e.g., people/c1234567890)
etagstringYesETag from a previous get request (required for concurrency control)
givenNamestringNoUpdated first name
familyNamestringNoUpdated last name
emailstringNoUpdated email address
emailTypestringNoEmail type: home, work, or other
phonestringNoUpdated phone number
phoneTypestringNoPhone type: mobile, home, work, or other
organizationstringNoUpdated organization/company name
jobTitlestringNoUpdated job title
notesstringNoUpdated notes or biography

Output

ParameterTypeDescription
contentstringContact update confirmation message
metadatajsonUpdated contact metadata

Google Contacts Delete

Delete a contact from Google Contacts

Input

ParameterTypeRequiredDescription
resourceNamestringYesResource name of the contact to delete (e.g., people/c1234567890)

Output

ParameterTypeDescription
contentstringContact deletion confirmation message
metadatajsonDeletion details including resource name
Was this helpful?
Suggest an edit