Companies

Companies group contacts under a single organisation. A contact can belong to one company. Companies can be used to filter contacts and roll up deal values.

GET/api/v1/companies

Return a paginated list of companies for your tenant.

Query parameters

Name	Type	Description
`page`	integer	Page number (default: 1)
`limit`	integer	Results per page — max 100 (default: 25)
`search`	string	Search by company name or domain

Example response

{
  "companies": [
    {
      "id": 55,
      "name": "Acme Corp",
      "domain": "acme.com",
      "industry": "Technology",
      "size": "51-200",
      "contact_count": 14,
      "addedtime": 1710000000
    }
  ],
  "total": 18,
  "page": 1,
  "limit": 25
}

GET/api/v1/companies/:id

Fetch a single company with its associated contacts.

Example response

{
  "id": 55,
  "name": "Acme Corp",
  "domain": "acme.com",
  "industry": "Technology",
  "size": "51-200",
  "contacts": [
    { "id": 1042, "first_name": "Jane", "last_name": "Doe" }
  ]
}

POST/api/v1/companies

Create a new company.

Request body

Field	Type	Description
`name`required	string	Company name
`domain`	string	Primary domain (e.g. acme.com)
`industry`	string	Industry category
`size`	string	Employee range (e.g. '51-200')
`phone`	string	Main phone number
`address`	string	Street address

Example request

curl -X POST https://app.pushbuttoncrm.com/api/v1/companies \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp",
    "domain": "acme.com",
    "industry": "Technology"
  }'

Example response

{
  "id": 56,
  "name": "Acme Corp",
  "domain": "acme.com",
  "industry": "Technology",
  "addedtime": 1710100000
}

PUT/api/v1/companies/:id

Replace all fields on a company.

Request body

Field	Type	Description
`name`required	string	Company name
`domain`	string	Primary domain
`industry`	string	Industry category
`size`	string	Employee range

Example response

{ "id": 55, "name": "Acme Corp", ... }

DELETE/api/v1/companies/:id

Delete a company. Associated contacts are not deleted — their company link is cleared.

Example response

{ "id": 55, "deleted": true }