Skip to main content
PUT
/
companies
/
{companyPublicId}
Update company
curl --request PUT \
  --url https://app.concretehq.com/api/v1/companies/{companyPublicId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Updated Company Name",
  "primaryDomain": "newdomain.com",
  "domains": [
    "newdomain.com",
    "new.io"
  ],
  "alternativeNames": [
    "Updated Corp"
  ],
  "headline": "Updated company description",
  "linkedinSlug": "updated-company",
  "twitterSlug": "updatedco",
  "crunchbaseSlug": "updated-company"
}'
{
  "publicId": "abc123def456",
  "name": "Acme",
  "primaryDomain": "acmecorp.com",
  "domains": [
    "acmecorp.com",
    "acme.io",
    "oldcompanyname.com"
  ],
  "headline": "Revolutionary AI software platform for enterprise automation",
  "alternativeNames": [
    "Acme Corp",
    "OldName Co"
  ],
  "linkedinSlug": "acme-corporation",
  "twitterSlug": "acmecorp",
  "crunchbaseSlug": "acme-corporation"
}

Authorizations

​
Authorization
string
header
required

API key authentication using Bearer token format

Path Parameters

​
companyPublicId
string
required

Company public ID

Body

application/json

All fields are optional for updates

​
name
string

Company name

Example:

"Updated Company Name"

​
primaryDomain
string

Primary domain of the company

Example:

"newdomain.com"

​
domains
string[]

Array of company domains

Example:
["newdomain.com", "new.io"]
​
alternativeNames
string[]

Array of alternative company names

Example:
["Updated Corp"]
​
headline
string

Company description

Maximum length: 256
Example:

"Updated company description"

​
linkedinSlug
string

LinkedIn profile slug

Example:

"updated-company"

​
twitterSlug
string

Twitter profile slug

Example:

"updatedco"

​
crunchbaseSlug
string

Crunchbase profile slug

Example:

"updated-company"

Response

Company updated successfully

Portfolio company object containing all company information and metadata. Companies are the core entities that Concrete tracks for portfolio intelligence.

​
publicId
string
required

Unique nanoid for the company.

Example:

"abc123def456"

​
name
string
required

Name of the company used for display purposes.

Required string length: 1 - 255
Example:

"Acme"

​
primaryDomain
string

Primary website domain of the company. Used as the main domain for email identification and company matching. Should be the most commonly used domain.

Example:

"acmecorp.com"

​
domains
string[]

Array of all company domains including historical and alternative domains. Concrete also inspects emails from these domains.

Example:
[
  "acmecorp.com",
  "acme.io",
  "oldcompanyname.com"
]
​
headline
string

Brief description of what the company does. Periodically auto-generated using company context.

Maximum length: 256
Example:

"Revolutionary AI software platform for enterprise automation"

​
alternativeNames
string[]

Array of alternative company names including abbreviations, former names, and commonly used variations.

Example:
["Acme Corp", "OldName Co"]
​
linkedinSlug
string

LinkedIn company page slug (the part after /company/ in LinkedIn URL). Used for social media integration and additional company context.

Example:

"acme-corporation"

​
twitterSlug
string

Twitter/X handle without the @ symbol.

Example:

"acmecorp"

​
crunchbaseSlug
string

Crunchbase company profile slug (the part after /organization/ in Crunchbase URL).

Example:

"acme-corporation"

⌘I