---
title: "Identify Company"
method: POST
path: "/v1/companies/identify"
---

# Identify Company

`POST /v1/companies/identify`

## Headers

- `Content-Type` string
- `Accept` string
- `Authorization` string, required

## Request body

- object
  - `company_id` string, required — The unique identifier for the company. This is the ID that Userpilot uses to identify the company.
  - `metadata` object — Optional company metadata. You can add, remove, or modify any properties as needed for your use case.
    - `custom_company_property` string — example: Company name, Industry, etc.

## Response `202`

Accepted - Company identification successful

## Other responses

- `400` — Bad Request - Invalid input
- `401` — Unauthorized - Invalid API key

---

[API](https://skmtc.net/userpilot/apis/userpilot-api.md) · [All operations](https://skmtc.net/userpilot/apis/userpilot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/userpilot/userpilot-api/versions/2b3a88b6a474/schema)