Skip to main content
GET
Get Contact

Request

Path Parameters

string
required
Contact UUID

Query Parameters

string
Optional comma-separated list of related resources to embed in the response. Accepts any of notes, tasks, deals, or * for all. When omitted, only the contact row is returned. One round-trip, no N+1.
  • include=notes → top 3 most recent notes in recent_notes[]
  • include=tasks → top 3 open tasks in open_tasks[]
  • include=deals → top 3 most recently-updated deals where this contact is the primary in open_deals[]
  • include=* → all three

Headers

Response

Self-healing names: first_name / last_name / full_name are always populated in the response, even for legacy rows where the DB has only full_name. The server derives the missing pieces on read via the same rules documented on Data Integrity.
object
The contact object (plus optional embedded resources when include= is set).

Example Response (with ?include=notes,tasks,deals)

Errors

Example 404 Response

You can only access contacts within your own workspace. Attempting to retrieve a contact from another workspace will return a 404 error.