Skip to main content
POST
/
companies
Create company
curl --request POST \
  --url https://app.concretehq.com/api/v1/companies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "New Company Name",
  "primaryDomain": "newcompany.com",
  "domains": [
    "newcompany.com",
    "newco.io"
  ],
  "alternativeNames": [
    "NewCo",
    "New Co"
  ],
  "headline": "Company description",
  "linkedinSlug": "new-company",
  "twitterSlug": "newcompany",
  "crunchbaseSlug": "new-company"
}
'
{
  "publicId": "abc123def456"
}

Authorizations

​
Authorization
string
header
required

API key authentication using Bearer token format

Body

application/json
​
name
string
required

Company name

Example:

"New Company Name"

​
primaryDomain
string

Primary domain of the company

Example:

"newcompany.com"

​
domains
string[]

Array of company domains

Example:
["newcompany.com", "newco.io"]
​
alternativeNames
string[]

Array of alternative company names

Example:
["NewCo", "New Co"]
​
headline
string

Company description

Maximum string length: 256
Example:

"Company description"

​
linkedinSlug
string

LinkedIn profile slug

Example:

"new-company"

​
twitterSlug
string

Twitter profile slug

Example:

"newcompany"

​
crunchbaseSlug
string

Crunchbase profile slug

Example:

"new-company"

Response

Company created successfully

​
publicId
string
required

Created company public ID

Example:

"abc123def456"