Skip to content
Browse docscreate_person

create_person

Creates one person in your private Rolodex. Resolve identity with list_people first. A first name is sufficient. This operation never silently updates an existing person.

InputRequiredMeaning
personyesResource fields described below.
person.ownerAuthoredNameyesYour private label, 1–120 characters.
person.emailsnoUp to 20 initial addresses, normalized and deduplicated.
person.linkedInnoSupplied url, company, and position.

After creating the person, use their ID with add_notes to provide profile context such as how you know them.

An email already owned in your Rolodex, or an existing displayed name when no email is supplied, rejects with already_exists and currentPerson. Review that person before an explicit update_person. For a different person with the same name, use an email or distinguishing name. No merge is performed.

Success returns the canonical Person directly, with the same fields as get_person, including its quoted opaque etag. MCP adds the exact Gravity link. There is no state, created, or changedFields wrapper. After an uncertain response, read current people before retrying; there is no general request replay key.

json
{
  "person": {
    "ownerAuthoredName": "Synthetic Pat",
    "emails": [
      "pat@example.test"
    ]
  }
}
json
{
  "personId": "00000000-0000-4000-a000-000000000005",
  "displayName": "Synthetic Pat",
  "contactAuthoredName": null,
  "ownerAuthoredName": "Synthetic Pat",
  "emails": [
    "pat@example.test"
  ],
  "etag": "\"cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc\"",
  "authoredSummary": null,
  "linkedIn": null,
  "sections": {
    "general": [],
    "areasOfDepth": [],
    "currentWork": [],
    "currentNeeds": [],
    "relationshipContext": []
  },
  "link": "https://www.meetgravity.ai/dashboard/rolodex?person=00000000-0000-4000-a000-000000000005"
}

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