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.
| Input | Required | Meaning |
|---|---|---|
personId | yes | Owned person ID resolved through List/Get. |
email | yes | Valid 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.
{
"personId": "00000000-0000-4000-a000-000000000005",
"email": "pat.work@example.test"
}
{
"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