Create a new person (contact/lead) in your team. People are automatically deduplicated by email address.

Use Cases:

• Add leads from website forms
• Import contacts from external systems
• Create prospects manually
• Sync contacts from marketing platforms

Deduplication:

• If an email address already exists, the existing person will be returned
• Use PUT /people/{id} to update existing contacts

Required vs Optional:

• A name is required: provide either firstName/lastName OR name
• At least one contact method is required: provide emails OR phones (or both)
• Tags can be added during creation for immediate categorization

Idempotency: This endpoint participates in automatic idempotent-replay — see the "Idempotency" section of the API overview for the full semantics (30-second window, X-Idempotent-Replay: true header, failure/retry behavior).

Example - Minimal Contact:

{
  "firstName": "Jane",
  "lastName": "Doe",
  "emails": [{"value": "[email protected]", "isPrimary": true}]
}

Example - Full Contact:

{
  "firstName": "John",
  "lastName": "Smith",
  "companyName": "Acme Corp",
  "stage": "Lead",
  "source": "Website Form",
  "emails": [
    {"value": "[email protected]", "type": "work", "isPrimary": true}
  ],
  "phones": [
    {"value": "+1-555-1234", "type": "mobile", "isPrimary": true}
  ],
  "addresses": [
    {
      "type": "work",
      "street": "123 Business St",
      "city": "Portland",
      "state": "OR",
      "code": "97201"
    }
  ],
  "tags": ["hot-lead", "buyer"],
  "assignedUserId": "user-uuid-here"
}