# Add or update a contact without making a duplicate

> Add or update a contact without making a duplicate: 0 companies fully do it, 3 with a limit, 4 carry the tag. Every listing in Contacts & address books with the reason and a source.

- Canonical: https://www.anchorterminal.com/niches/contacts.save-contact/
- Markdown: https://www.anchorterminal.com/niches/contacts.save-contact/index.md (~800 tokens)
- Slim: https://www.anchorterminal.com/niches/contacts.save-contact/index.min.md (~280 tokens, same facts, less prose, for token-sensitive contexts)
- JSON: https://www.anchorterminal.com/niches/contacts.save-contact/index.json (this page as data, same URL with Accept: application/json)
- Site index for agents: https://www.anchorterminal.com/llms.txt (the key docs and every listing in one file, at most 16 MB, about 4 million tokens: https://www.anchorterminal.com/llms-full.txt)
- API: https://www.anchorterminal.com/api/v1/index.json
- MCP: https://www.anchorterminal.com/mcp (the whole catalogue as tools, no key)
- DNS: dig +short TXT <slug>.grade.anchorterminal.com (the grade as a DNS TXT record, for a sandbox with no HTTP where names still resolve; also top., best.<category>. and <a>.vs.<b>. under the zone, and the same under grade.letme.dev)
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)
- Updated: 2026-11-15

No company's docs show a full fit yet. The listings below do the job with a limit, or not at all.

| Companies, full fit | With a limit | Carry the tag | Share of the category's work | First-hand accounts |
| --- | --- | --- | --- | --- |
| 0 | 3 | 4 | 24 | 5 |

## What counts as done

Before creating, the agent can find an existing record by email or phone; create and update accept every field the docs list (phones, addresses, organisation, custom fields), updates use an etag or version so a stale write is refused with a clear error, and the docs say how duplicates are merged or flagged for review.

How agents ask for it: save this person's details; update Jo's new number; add the people from this email thread

## Does the job, with a limit

It does the job, but something in the docs or a user's account will get in an agent's way. The limit is named in each row.

- **ContactsPlus (Contacts Plus LLC)**: Search before create; contacts.update takes the current etag and a resolveConflicts flag. No idempotency key, the stale-etag error is not documented, and dedupe is an app feature; MCP writes land in Suggestions for the owner to approve.
- **Google People API (Google LLC)**: Search first, then createContact; updates need the source etag and a stale one returns 400 failedPrecondition. No idempotency key on create, mutations for a user must be sequential, acc-07 saw etag mismatches on fresh etags, and acc-08 lost fields on create.
- **Microsoft Graph People and Contacts API (Microsoft Corporation)**: Look up first with $filter on emailAddresses/any, then create or PATCH with Contacts.ReadWrite. No idempotency key, no etag or If-Match precondition is documented on update (only changeKey in the body), and no duplicate merge is described.

## What stops agents finishing

- no idempotency key on create, so a retry duplicates
- write not visible to search for minutes
- etag mismatch on back-to-back updates

## Around it

Before: mailbox-access.read-thread, document-extraction.read-card. After: contacts.sync-copy, crm.upsert-contact.

## Where this comes from

Weight 24 of 100 in Contacts & address books: 5 accounts (acc-07 to acc-11) on etag errors, missing fields and duplicates

As data: https://www.anchorterminal.com/api/v1/use-cases/contacts.save-contact.json, or the MCP tool get_use_case with id contacts.save-contact. Draft, read 2026-11-15 from public docs and first-hand accounts, not yet reviewed by a person.

---

Query this catalogue directly over MCP: https://www.anchorterminal.com/mcp (Streamable HTTP, no key). How: https://www.anchorterminal.com/agents/#mcp
