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
Company name (1-255 characters)
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}$
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.
Automatically add all existing contacts with matching email domains to this company
Company size (number of employees). If Linear is connected, this will be synced to the Linear customer.
Annual revenue. If Linear is connected, this will be synced to the Linear customer.
Linear customer tier ID. Only works if Linear is connected. Use GET /companies/linear-options to fetch available tier IDs.
Linear customer status ID. Only works if Linear is connected. Use GET /companies/linear-options to fetch available status IDs.
Response
Unique identifier for the created company
List of domains associated with the company
External IDs for the company
Whether to automatically add contacts with matching domains
Company size (number of employees)
Linear customer status ID
Timestamp when the company was created
Timestamp when the company was last updated
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"
}
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Required string length: 1 - 255
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.
Your own organization IDs for referencing this company. Useful for linking freelancers or contacts with generic email domains (e.g., @gmail.com) to companies. If Linear is connected, these IDs will be synced as Linear customer externalIds.
Automatically add all existing contacts with matching email domains to this company
Company size (number of employees). If Linear is connected, this will be synced to the Linear customer.
Annual revenue. If Linear is connected, this will be synced to the Linear customer.
Linear customer tier ID. Only works if Linear is connected. Use GET /companies/linear-options to fetch available tier IDs.
Linear customer status ID. Only works if Linear is connected. Use GET /companies/linear-options to fetch available status IDs.
The response is of type any.
