Create company

Create a company. Linear customer is provisioned asynchronously once a domain is set. Requires the companies:write scope.

POST

/api/v2/companies

POST

/companies

curl -X POST "https://productlane.com/api/v2/companies" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string"
}'

Authorization

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

Body

application/json

name
string
required
logo_url
string<uri> | null
domains
string[]
size
integer
revenue
integer
external_ids
string[]
Replaces the company's full external-id set. Use for cross-system identifiers (CRM ids, etc.).
status_id
string | null
Linear customer-status id. Fetch valid ids from GET /companies/linear-options. Pass null to clear.
tier_id
string | null
Linear customer-tier id. Fetch valid ids from GET /companies/linear-options. Pass null to clear.
owner_id
string | null
Linear user id of the owner. Fetch valid ids from GET /companies/linear-options. Pass null to clear.

Response

application/json

Successful response

id
string
required
name
string
required
logo_url
string | null
required
domains
string[]
required
size
number | null
required
revenue
number | null
required
status_id
string | null
required
status_name
string | null
required
tier_id
string | null
required
tier_name
string | null
required
owner
object | null
required
external_ids
string[]
required
Caller-owned cross-system identifiers (CRM ids, etc.). Replaced wholesale on create/update.
integration_ids
object
required
created_at
string
required
updated_at
string
required

{
  "id": "string",
  "name": "string",
  "logo_url": "string",
  "domains": [
    "string"
  ],
  "size": 0,
  "revenue": 0,
  "status_id": "string",
  "status_name": "string",
  "tier_id": "string",
  "tier_name": "string",
  "owner": {
    "id": "string",
    "name": "string",
    "avatar_url": "string"
  },
  "external_ids": [
    "string"
  ],
  "integration_ids": {
    "intercom": "string",
    "front": "string",
    "zendesk": "string",
    "hubspot": "string",
    "plain": "string",
    "productboard": "string",
    "slack_channel": "string"
  },
  "created_at": "string",
  "updated_at": "string"
}

POST

/companies

curl -X POST "https://productlane.com/api/v2/companies" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string"
}'

{
  "id": "string",
  "name": "string",
  "logo_url": "string",
  "domains": [
    "string"
  ],
  "size": 0,
  "revenue": 0,
  "status_id": "string",
  "status_name": "string",
  "tier_id": "string",
  "tier_name": "string",
  "owner": {
    "id": "string",
    "name": "string",
    "avatar_url": "string"
  },
  "external_ids": [
    "string"
  ],
  "integration_ids": {
    "intercom": "string",
    "front": "string",
    "zendesk": "string",
    "hubspot": "string",
    "plain": "string",
    "productboard": "string",
    "slack_channel": "string"
  },
  "created_at": "string",
  "updated_at": "string"
}

- Introduction
- Authentication
- MCP Server
- Errors
- Rate limits
- Pagination
- Article content
- Webhooks
- Migrating from API v1 to v2

APICompanies

Create company

Create a company. Linear customer is provisioned asynchronously once a domain is set. Requires the companies:write scope.

POST

/api/v2/companies

POST

/companies

curl -X POST "https://productlane.com/api/v2/companies" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string"
}'

Authorization

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

Body

application/json

name
string
required
logo_url
string<uri> | null
domains
string[]
size
integer
revenue
integer
external_ids
string[]
Replaces the company's full external-id set. Use for cross-system identifiers (CRM ids, etc.).
status_id
string | null
Linear customer-status id. Fetch valid ids from GET /companies/linear-options. Pass null to clear.
tier_id
string | null
Linear customer-tier id. Fetch valid ids from GET /companies/linear-options. Pass null to clear.
owner_id
string | null
Linear user id of the owner. Fetch valid ids from GET /companies/linear-options. Pass null to clear.

Response

application/json

Successful response

id
string
required
name
string
required
logo_url
string | null
required
domains
string[]
required
size
number | null
required
revenue
number | null
required
status_id
string | null
required
status_name
string | null
required
tier_id
string | null
required
tier_name
string | null
required
owner
object | null
required
external_ids
string[]
required
Caller-owned cross-system identifiers (CRM ids, etc.). Replaced wholesale on create/update.
integration_ids
object
required
created_at
string
required
updated_at
string
required

{
  "id": "string",
  "name": "string",
  "logo_url": "string",
  "domains": [
    "string"
  ],
  "size": 0,
  "revenue": 0,
  "status_id": "string",
  "status_name": "string",
  "tier_id": "string",
  "tier_name": "string",
  "owner": {
    "id": "string",
    "name": "string",
    "avatar_url": "string"
  },
  "external_ids": [
    "string"
  ],
  "integration_ids": {
    "intercom": "string",
    "front": "string",
    "zendesk": "string",
    "hubspot": "string",
    "plain": "string",
    "productboard": "string",
    "slack_channel": "string"
  },
  "created_at": "string",
  "updated_at": "string"
}

POST

/companies

curl -X POST "https://productlane.com/api/v2/companies" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string"
}'

{
  "id": "string",
  "name": "string",
  "logo_url": "string",
  "domains": [
    "string"
  ],
  "size": 0,
  "revenue": 0,
  "status_id": "string",
  "status_name": "string",
  "tier_id": "string",
  "tier_name": "string",
  "owner": {
    "id": "string",
    "name": "string",
    "avatar_url": "string"
  },
  "external_ids": [
    "string"
  ],
  "integration_ids": {
    "intercom": "string",
    "front": "string",
    "zendesk": "string",
    "hubspot": "string",
    "plain": "string",
    "productboard": "string",
    "slack_channel": "string"
  },
  "created_at": "string",
  "updated_at": "string"
}