{
  "data": null,
  "kind": "anchor.page",
  "links": {
    "api": "https://www.anchorterminal.com/api/v1/index.json",
    "html": "https://www.anchorterminal.com/niches/contacts.save-contact/",
    "json": "https://www.anchorterminal.com/niches/contacts.save-contact/index.json",
    "llms": "https://www.anchorterminal.com/llms.txt",
    "markdown": "https://www.anchorterminal.com/niches/contacts.save-contact/index.md",
    "mcp": "https://www.anchorterminal.com/mcp",
    "slim": "https://www.anchorterminal.com/niches/contacts.save-contact/index.min.md"
  },
  "markdown": "No company's docs show a full fit yet. The listings below do the job with a limit, or not at all.\n\n| Companies, full fit | With a limit | Carry the tag | Share of the category's work | First-hand accounts |\n| --- | --- | --- | --- | --- |\n| 0 | 3 | 4 | 24 | 5 |\n\n## What counts as done\n\nBefore 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.\n\nHow agents ask for it: save this person's details; update Jo's new number; add the people from this email thread\n\n## Does the job, with a limit\n\nIt 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.\n\n- **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.\n- **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.\n- **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.\n\n## What stops agents finishing\n\n- no idempotency key on create, so a retry duplicates\n- write not visible to search for minutes\n- etag mismatch on back-to-back updates\n\n## Around it\n\nBefore: mailbox-access.read-thread, document-extraction.read-card. After: contacts.sync-copy, crm.upsert-contact.\n\n## Where this comes from\n\nWeight 24 of 100 in Contacts \u0026 address books: 5 accounts (acc-07 to acc-11) on etag errors, missing fields and duplicates\n\nAs 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.\n",
  "meta": {
    "attribution": "Anchor Terminal (https://www.anchorterminal.com)",
    "attributionRequired": true,
    "credit": "CC BY 4.0, credit Anchor Terminal and link the page or API address you took it from (https://www.anchorterminal.com/terms/#data)",
    "docs": "https://www.anchorterminal.com/docs/",
    "generatedAt": "2026-11-16",
    "license": "CC-BY-4.0",
    "method": "https://www.anchorterminal.com/benchmark/",
    "methodology": "0.8",
    "openapi": "https://www.anchorterminal.com/openapi.json",
    "preview": false,
    "run": "2026-10-01",
    "runLabel": "October 2026 research run",
    "terms": "https://www.anchorterminal.com/terms/#data"
  },
  "page": {
    "breadcrumbs": [
      {
        "name": "Home",
        "url": "https://www.anchorterminal.com/"
      },
      {
        "name": "For agents",
        "url": "https://www.anchorterminal.com/agents/"
      },
      {
        "name": "Niches",
        "url": "https://www.anchorterminal.com/niches/"
      },
      {
        "name": "Add or update a contact without making a duplicate",
        "url": ""
      }
    ],
    "description": "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 \u0026 address books with the reason and a source.",
    "facts": null,
    "h1": "Add or update a contact without making a duplicate",
    "image": "https://www.anchorterminal.com/assets/og/default.png",
    "path": "/niches/contacts.save-contact/",
    "published": "",
    "section": "agents",
    "title": "Add or update a contact without making a duplicate | Anchor Terminal",
    "toc": null,
    "updated": "2026-11-15",
    "url": "https://www.anchorterminal.com/niches/contacts.save-contact/"
  },
  "tokens": {
    "markdown": 800,
    "slim": 280
  },
  "version": 1
}
