Skip to main content
POST
/
companies
Create company
curl --request POST \
  --url https://productlane.com/api/v1/companies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "domains": [
    "<string>"
  ],
  "externalIds": [
    "<string>"
  ],
  "autoAdd": false
}'
{
  "id": "<string>",
  "name": "<string>",
  "domains": [
    "<string>"
  ],
  "externalIds": [
    "<string>"
  ],
  "autoAdd": true,
  "size": 123,
  "revenue": 123,
  "tierId": "<string>",
  "statusId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "workspaceId": "<string>"
}

​
Create Company

Create a new company in your workspace. Companies can be linked to contacts by email domain and integrated with Linear if connected.

​
Request Body

​
name
string
required
Company name (1-255 characters)
​
domains
string[]
List of domains associated with this company. Used for automatically linking contacts by email domain. If Linear is connected, these domains will be synced to the Linear customer.Each domain must match the pattern: [0-9a-z-]+\.(?:(?:co|or|gv|ac|com)\.)?[a-z]{2,7}$
​
externalIds
string[]
Your own organization IDs for referencing this company. Useful for linking contacts with generic email domains (e.g., @gmail.com) to companies. If Linear is connected, these IDs will be synced as Linear customer externalIds.
​
autoAdd
boolean
default:"false"
Automatically add all existing contacts with matching email domains to this company
​
size
number
Company size (number of employees). If Linear is connected, this will be synced to the Linear customer.
​
revenue
number
Annual revenue. If Linear is connected, this will be synced to the Linear customer.
​
tierId
string
Linear customer tier ID. Only works if Linear is connected. Use GET /companies/linear-options to fetch available tier IDs.
​
statusId
string
Linear customer status ID. Only works if Linear is connected. Use GET /companies/linear-options to fetch available status IDs.

​
Response

​
id
string
Unique identifier for the created company
​
name
string
Company name
​
domains
string[]
List of domains associated with the company
​
externalIds
string[]
External IDs for the company
​
autoAdd
boolean
Whether to automatically add contacts with matching domains
​
size
number
Company size (number of employees)
​
revenue
number
Annual revenue
​
tierId
string
Linear customer tier ID
​
statusId
string
Linear customer status ID
​
createdAt
string
Timestamp when the company was created
​
updatedAt
string
Timestamp when the company was last updated
​
workspaceId
string
ID of the workspace this company belongs to

​
Example Request

{
  "name": "Acme Corp",
  "domains": ["acme.com", "acme.io"],
  "externalIds": ["ACME-001"],
  "autoAdd": true,
  "size": 50,
  "revenue": 1000000
}

​
Example Response

{
  "id": "comp_123456789",
  "name": "Acme Corp",
  "domains": ["acme.com", "acme.io"],
  "externalIds": ["ACME-001"],
  "autoAdd": true,
  "size": 50,
  "revenue": 1000000,
  "tierId": null,
  "statusId": null,
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z",
  "workspaceId": "ws_123456789"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required
Required string length: 1 - 255
​
domains
string[]
​
externalIds
string[]

Your own organization IDs for referencing this company

​
autoAdd
boolean
default:false

Response

Successful response

​
id
string
required
​
name
string
required
​
domains
string[]
required
​
externalIds
string[]
required
​
autoAdd
boolean
required
​
size
integer
required
​
revenue
integer
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
workspaceId
string
required
​
tierId
string | null
​
statusId
string | null