Identify Company

Identify and update company profiles in real time or in bulk using Userpilot’s HTTP API.

The Identify Company API allows you to create or update company profiles in real time, either individually or in bulk. Use this API to keep your company data in sync with Userpilot for analytics, segmentation, and B2B engagement.

Individual Identify

Endpoint

[POST] https://analytex.userpilot.io/v1/companies/identify

The endpoint URL uses the analytex environment. For EU data residency, use analytex-eu instead. See Environment Settings for your specific endpoint.

Headers

Header	Value	Required
Content-Type	application/json	Yes
Authorization	Token {YOUR_API_KEY}	Yes
Accept	application/json, text/plain, */*	Yes

Request Body

Field	Type	Required	Description
company_id	string	Yes	Unique identifier for the company
metadata	object	No	Key-value pairs describing the company (e.g., name, industry, etc.)

Example

{
  "company_id": "company_001",
  "metadata": {
    "name": "Acme Corporation",
    "industry": "SaaS",
    "plan": "Enterprise",
    "monthly_spend": 1000
  }
}

Response

A successful identification returns HTTP status code 200 OK.

The company_id field is required. Metadata values must be primitive types (string, number, boolean, null).

---

Bulk Operations

For bulk company identification and updates, see the dedicated documentation:

• Bulk Identify Companies - For bulk company operations

These articles provide comprehensive details on endpoints, authentication, request/response examples, limitations, best practices, and troubleshooting for large-scale data synchronization.

---