Skip to main content
Talk to salesStart

Create company

Create or resolve an organization company from an identity signal.

POST/api/companies/
HTTP referenceScope companies:writeUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

At least one concrete identity signal is required: name, domain, linkedin_url, or linkedinCompanyId. A successful response includes the serialized Company plus created and unapplied_custom_fields; the shown response is an abridged shape.

Body parameters

  • name · optional

    string

    Company name; at least one identity signal is required.

  • domain · optional

    string

    Company domain.

  • industry · optional

    string

    Industry.

  • employee_count · optional

    string

    Employee count.

  • location · optional

    string

    Location.

  • city · optional

    string

    City.

  • state · optional

    string

    State or region.

  • country · optional

    string

    Country.

  • zip_code · optional

    string

    Postal code.

  • timezone · optional

    string

    Timezone.

  • phone · optional

    string

    Phone.

  • linkedin_url · optional

    string

    LinkedIn company URL; valid identity signal.

  • linkedinCompanyId · optional

    string

    LinkedIn company ID; valid identity signal.

  • ownerUserId · optional

    string

    Owner user ID.

  • custom_fields · optional

    object

    Custom field values.

Errors

StatusMeaning
400Invalid domain, phone, owner, or custom-field value.
401Invalid API key or missing organization context.
403Missing companies:write scope.
422No concrete name, domain, LinkedIn URL, or LinkedIn company ID was supplied.

Docs