DocsAPIPeople

Update person

Updates an existing person (contact). Only the provided fields are changed. If email is updated, it must remain unique in the workspace – a 409 is returned otherwise.

PATCH
/people/{id}
Path

Contact ID

Example: 1

Body

Example: jane@acme.com

Example: Jane Doe

Example: ["founder"]

Example: true

Request Body

application/jsonOptional
emailstring

Email address. Must be unique in the workspace – a 409 is returned if another person already uses it.

Format: "email"
namestring

Full name

tagsarray<string>

Tags for categorization (replaces existing tags)

is_reporting_contactboolean

Whether this person is a reporting contact

Path Parameters

idRequiredstring

Contact ID

Pattern: "^\\d+$"

Credentials

Bearer
curl -X PATCH "https://api.fundra.com/v1/people/1" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "jane@acme.com",
    "name": "Jane Doe",
    "tags": [
      "founder"
    ],
    "is_reporting_contact": true
  }'

Person updated successfully

{
  "data": {
    "id": "1",
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "company_id": "42",
    "name": "Jane Doe",
    "email": "jane@acme.com",
    "phone": "+1 555 123 4567",
    "title": "Chief Executive Officer",
    "seniority": "C-Level",
    "functions": [
      "CEO"
    ],
    "description": "Serial founder, previously at Acme",
    "country": "United States",
    "city": "San Francisco",
    "avatar_url": "https://example.com/avatar.png",
    "linkedin_url": "https://linkedin.com/in/janedoe",
    "twitter_url": "https://x.com/janedoe",
    "facebook_url": null,
    "github_url": null,
    "cb_url": null,
    "linkedin_org_name": "Acme Inc",
    "tags": [
      "founder"
    ],
    "is_reporting_contact": true,
    "last_seen": "2024-01-15T10:00:00Z",
    "created_at": "2024-01-15T10:00:00Z",
    "updated_at": "2024-02-20T09:00:00Z"
  }
}

Previous

Add person to a companyPOST

Next

List usersGET