---
title: "Identify a contact"
method: POST
path: "/contacts/identify"
---

# Identify a contact

`POST /contacts/identify`

## Request body

- Contact
  - `id` string, required — External contact ID
  - `shouldUnflattenProperties` boolean, nullable — Whether to unflatten properties that are meant to be nested objects for example `{ "plan.type": "Pro" }` will be unflattened to `{ "plan": { "type": "Pro" } }`
  - `properties` object, nullable — Properties prefixed with `$` are handled specially. Otherwise, additional key-value pairs will be metadata once ingested into the system
    - `$email` string, nullable
    - `$name` string, nullable
    - `$createdAt` string, date-time, nullable
    - `$updatedAt` string, date-time, nullable
    - `$contractValue` number, nullable — The contract value of the contact.
  - `account` Account
    - `id` string, required — The unique identifier for the account.
    - `shouldUnflattenProperties` boolean, nullable — Whether to unflatten properties that are meant to be nested objects for example `{ "plan.type": "Pro" }` will be unflattened to `{ "plan": { "type": "Pro" } }`
    - `properties` object
      - `$name` string, required — The name of the account.
      - `$domain` string, required — The domain of the account.
      - `$createdAt` string, date-time, nullable
      - `$updatedAt` string, date-time, nullable
      - `$contractValue` number, nullable — The contract value of the account.
  - `source` string, nullable — Source system to limit search to

## Response `201`

The customer was identified successfully

- object
  - `success` boolean

---

[API](https://skmtc.net/monterey-ai/apis/reforge-insights-formerly-monterey-ai-api.md) · [All operations](https://skmtc.net/monterey-ai/apis/reforge-insights-formerly-monterey-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monterey-ai/reforge-insights-formerly-monterey-ai-api/revisions/fd623cac2355/schema)