---
title: "Identify an account"
method: POST
path: "/accounts/identify"
---

# Identify an account

`POST /accounts/identify`

## Request

- Base URL: `https://insights.reforge.com/api/v1`
- URL: `https://insights.reforge.com/api/v1/accounts/identify`
- Auth: HTTP bearer

## Request body

- 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.

## Response `201`

The account was identified successfully

- object
  - `success` boolean

## Changes

- **2025-02-26** `f8820abd2c00`: 1 info
  - endpoint added
- **2023-09-19** `a6a571883e5f`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/monterey-ai/apis/reforge-insights-formerly-monterey-ai-api/changes/accounts/identify/post.md)

---

[API](https://skmtc.dev/monterey-ai/apis/reforge-insights-formerly-monterey-ai-api.md) - [All operations](https://skmtc.dev/monterey-ai/apis/reforge-insights-formerly-monterey-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monterey-ai/apis/reforge-insights-formerly-monterey-ai-api/revisions/fd623cac2355?raw)
