Skip to content
Browse docsadd_person_email

add_person_email

Adds one address to an exact person in your private Rolodex. Existing addresses remain. This is an explicit additive action, separate from field-replacing update_person.

InputRequiredMeaning
personIdyesOwned person ID resolved through List/Get.
emailyesValid email address, up to 254 characters; trimmed and lowercased.

An address already on this person returns already_exists with currentPerson. An address assigned to another person rejects the operation. The action never removes addresses, moves ownership, merges people, changes profile statements, or sends mail.

Success returns the canonical Person directly, including the updated etag and its Gravity link. No etag is required because the addition is atomic and does not replace the address list. After an uncertain outcome, read get_person before retrying. There is no original-result replay guarantee.

json
{
  "personId": "00000000-0000-4000-a000-000000000005",
  "email": "pat.work@example.test"
}
json
{
  "personId": "00000000-0000-4000-a000-000000000005",
  "displayName": "Synthetic Pat",
  "contactAuthoredName": "Synthetic Pat",
  "ownerAuthoredName": null,
  "emails": [
    "pat.work@example.test",
    "pat@example.test"
  ],
  "etag": "\"dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd\"",
  "authoredSummary": null,
  "linkedIn": {
    "url": null,
    "company": "Synthetic company",
    "position": "Designer"
  },
  "sections": {
    "general": [],
    "areasOfDepth": [],
    "currentWork": [
      {
        "statementId": "00000000-0000-4000-a000-000000000007",
        "text": "Building a synthetic product",
        "revision": 1,
        "scope": null,
        "uncertainty": null
      }
    ],
    "currentNeeds": [],
    "relationshipContext": [
      {
        "statementId": "00000000-0000-4000-a000-000000000008",
        "text": "You worked together",
        "revision": 1,
        "scope": null,
        "uncertainty": null
      }
    ]
  },
  "link": "https://www.meetgravity.ai/dashboard/rolodex?person=00000000-0000-4000-a000-000000000005"
}

Annotations: readOnlyHint: false · destructiveHint: false · idempotentHint: false · openWorldHint: false