DocsAPIPeople

Add person to a company

Adds a new person (contact) to a company. company_id and email are required. Duplicates are prevented by email – if a person with the same email already exists in the workspace, a 409 is returned.

POST
/people
Body

Example: 42

Example: jane@acme.com

Example: Jane Doe

Example: CEO

Example: +1 555 123 4567

Example: ["founder"]

Example: false

Request Body

application/jsonOptional
company_idRequiredstring

ID of the company to add this person to (required)

Pattern: "^\\d+$"
emailRequiredstring

Email address (required, used to prevent duplicates)

Format: "email"
namestring

Full name

titlestring

Job title

phonestring

Phone number

tagsarray<string>

Tags for categorization

is_reporting_contactboolean

Whether this person is a reporting contact

Credentials

Bearer
curl -X POST "https://api.fundra.com/v1/people" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "company_id": "42",
    "email": "jane@acme.com",
    "name": "Jane Doe",
    "title": "CEO",
    "phone": "+1 555 123 4567",
    "tags": [
      "founder"
    ],
    "is_reporting_contact": false
  }'

Person created 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

List peopleGET

Next

Update personPATCH