Companies

Companies represent organizations or businesses that your users belong to. Use this endpoint to list and retrieve company information.

List all companies

GET/v2/companies

Create or update a company

POST/v2/companies

Get company by ID

GET/v2/companies/{id}

Delete a company

DELETE/v2/companies/{id}

Delete a company by external company ID

DELETE/v2/companies/by-company-id/{companyId}

ModelsExpand Collapse

Company object { id, companyId, companySize, 11 more }

id: string

Featurebase internal ID

companyId: string

External company ID from your system

companySize: number

Company employee headcount

createdAt: string

ISO date when company was created

industry: string

Industry

lastActivity: string

ISO date of last activity

linkedUsers: number

Number of users linked to this company

monthlySpend: number

Monthly spend

name: string

Company name

object: "company"

Object type identifier

plan: string

Plan or tier name

updatedAt: string

ISO date when company was last updated

website: string

Company website URL

customFields: optional map[unknown]

Custom field values

DeletedCompany object { id, deleted, object }

id: string

Unique identifier of the deleted company

deleted: true

Indicates the resource was deleted

object: "company"

Object type identifier

CompaniesContacts

Companies represent organizations or businesses that your users belong to. Use this endpoint to list and retrieve company information.

List contacts attached to a company

GET/v2/companies/{id}/contacts

Attach a contact to a company

POST/v2/companies/{id}/contacts

Remove a contact from a company

DELETE/v2/companies/{id}/contacts/{contactId}

ModelsExpand Collapse

ContactAttachResponse = Contact { id, name, object, 16 more }

User who submitted the response

ContactRemoveResponse = Contact { id, name, object, 16 more }

User who submitted the response