Skip to main content
POST
/
v1
/
companies
/
identify
Identify Company
curl --request POST \
  --url https://{environment}.userpilot.io/v1/companies/identify \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_id": "comp_techstartup_2024",
  "metadata": {
    "name": "Acme Corporation",
    "industry": "Technology",
    "size": "100-500",
    "location": "San Francisco, CA",
    "website": "https://acme.com",
    "subscription_tier": "Enterprise",
    "annual_revenue": "$10M-$50M",
    "founded_year": "2020"
  }
}
'
{
  "errors": [
    {
      "details": "<string>",
      "error": "<string>",
      "error_code": "<string>",
      "message": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.userpilot.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
Content-Type
string
default:application/json
​
Accept
string
default:application/json
​
Authorization
string
default:Token ABC_1234_EFGH_5678
required

API authentication token in the format: Token {{API_KEY}} Obtain your API key from the Userpilot Environment Settings.

Body

application/json
​
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.

Response

Accepted - Company identification successful