---
title: "Get Google Contacts"
method: GET
path: "/api/google/contacts"
tags: ["google-api"]
---

# Get Google Contacts

`GET /api/google/contacts`

Get user's Google contacts.

Always pulls from People API "My Contacts" (`people.connections`). When
`include_other=True` (default), also pulls "Other Contacts" — the bucket
Gmail auto-populates from any email recipient (To/CC/BCC) the user has
sent to. Per Google's Contacts Help docs, Other Contacts captures the full
history of email recipients, so it covers what a Gmail-sent-folder scan
would otherwise return — without the cost of thousands of message reads.

`google_account_id` (optional) selects which of the user's connected Google
accounts to pull from; default is the primary, unchanged.

Returns a single deduped list. The two buckets are merged on lowercase
email; My Contacts wins on collision (richer profile data).

## Query parameters

- `user_id` string
- `org_id` string
- `max_results` integer
- `fetch_all` boolean
- `include_other` boolean
- `google_account_id` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/every/apis/every-api.md) · [All operations](https://skmtc.net/every/apis/every-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/every/every-api/versions/9744001af85d/schema)