{
  "listings": [
    {
      "slug": "contactsplus",
      "name": "ContactsPlus",
      "company": "Contacts Plus LLC",
      "grade": "E",
      "fit": "caveat",
      "why": "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.",
      "source": "https://www.contactsplus.com/developers/contacts-api/",
      "confidence": "high",
      "url": "https://www.anchorterminal.com/tools/contactsplus"
    },
    {
      "slug": "google-people-api",
      "name": "Google People API",
      "company": "Google LLC",
      "grade": "B",
      "fit": "caveat",
      "why": "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.",
      "source": "https://developers.google.com/people/api/rest/v1/people/createContact",
      "confidence": "high",
      "url": "https://www.anchorterminal.com/tools/google-people-api"
    },
    {
      "slug": "microsoft-graph-people",
      "name": "Microsoft Graph People and Contacts API",
      "company": "Microsoft Corporation",
      "grade": "C",
      "fit": "caveat",
      "why": "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.",
      "source": "https://learn.microsoft.com/en-us/graph/api/user-list-contacts?view=graph-rest-1.0",
      "confidence": "high",
      "url": "https://www.anchorterminal.com/tools/microsoft-graph-people"
    }
  ],
  "marks": "yes: the docs show it does the job as the success test says. caveat: it does the job with a limit an agent should know. no: it doesn't do this job. unchecked: we couldn't read it.",
  "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"
  },
  "useCase": {
    "accounts": 5,
    "after": [
      "contacts.sync-copy",
      "crm.upsert-contact"
    ],
    "area": "everyday",
    "asks": [
      "save this person's details",
      "update Jo's new number",
      "add the people from this email thread"
    ],
    "before": [
      "mailbox-access.read-thread",
      "document-extraction.read-card"
    ],
    "blockers": [
      "no idempotency key on create, so a retry duplicates",
      "write not visible to search for minutes",
      "etag mismatch on back-to-back updates"
    ],
    "capabilities": [
      "contacts.write",
      "contacts.search"
    ],
    "category": "contacts",
    "categoryName": "Contacts \u0026 address books",
    "checked": "2026-11-15",
    "companies": {
      "fit": 0,
      "fitWithLimit": 3,
      "tagged": 4
    },
    "competition": "none",
    "fits": null,
    "fitsWithLimit": [
      "contactsplus",
      "google-people-api",
      "microsoft-graph-people"
    ],
    "id": "contacts.save-contact",
    "listings": {
      "caveat": 3,
      "no": 0,
      "notRead": 0,
      "tagged": 4,
      "unchecked": 0,
      "yes": 0
    },
    "name": "Add or update a contact without making a duplicate",
    "status": "draft",
    "success": "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.",
    "url": "https://www.anchorterminal.com/api/v1/use-cases/contacts.save-contact.json",
    "weight": 24,
    "weightBasis": "5 accounts (acc-07 to acc-11) on etag errors, missing fields and duplicates"
  }
}
