HEhellobonsai
Companies

Create a company

Adds a company to your CRM. Only name is required.

Search the list endpoint by name first — nothing here deduplicates for you, so creating a company you already have leaves you with two.

Every company created through the API is a client. Vendors cannot be created here.

post/public-api/v1/companies

Request

  • Base URL
    https://app.hellobonsai.com
  • URL
    https://app.hellobonsai.com/public-api/v1/companies
  • Auth
    • OAuth 2
      Authorization code: https://app.hellobonsai.com/oauth/authorize
      Token URL: https://app.hellobonsai.com/oauth/token
    • or HTTP bearer

Request body

Example request

{
  "company": {
    "name": "Acme Corp",
    "default_contact_id": 7,
    "description": "Long standing retainer client.",
    "industry": "computers_electronics_and_technology",
    "company_size": "size_201_1000",
    "source": "organic_search",
    "linkedin": "https://linkedin.com/company/acme",
    "instagram": "https://instagram.com/acme",
    "twitter": "https://x.com/acme",
    "facebook": "https://facebook.com/acme",
    "domains": [
      "example.com",
      "example.net"
    ]
  }
}

Response

The company was created.

Example response

{
  "data": {
    "id": 42,
    "name": "Acme Corp",
    "default_contact_id": 7,
    "description": "Long standing retainer client.",
    "industry": "computers_electronics_and_technology",
    "company_size": "size_201_1000",
    "source": "organic_search",
    "linkedin": "https://linkedin.com/company/acme",
    "instagram": "https://instagram.com/acme",
    "twitter": "https://x.com/acme",
    "facebook": "https://facebook.com/acme",
    "archived_at": "2026-04-14T09:12:04.000Z",
    "created_at": "2026-04-14T09:12:04.000Z",
    "domains": [
      "example.com",
      "example.net"
    ],
    "avatar_url": "https://logo.clearbit.com/acme.com",
    "url": "https://app.hellobonsai.com/companies/42"
  },
  "meta": {
    "request_id": "b1f0d2c4-7a9e-4c3b-8d5f-1e2a3b4c5d6e"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.