<!-- Source: https://docs.vinsi.ai/api-docs/crm-company-create -->
# Create Company

Create a CRM company. name is required. type defaults to prospect. The owner is set to the user who owns the API key. If primaryContactId points at a contact with no company yet, that contact is linked to the new company (linkedContactsCount). Responds 201.

```http
POST https://dashboard.vinsi.ai/api/crm/companies
```

## Authentication

Send your API key in the `x-api-key` header. Create keys in the VINSI dashboard under Settings → API Keys.

## Headers

| Name | Type | Required |
|---|---|---|
| Content-Type | string | yes (application/json) |
| x-api-key | string | yes |

## Example request body

```json
{
  "name": "Acme Dental",
  "industry": "Healthcare",
  "website": "https://acme-dental.example.com",
  "phone": "+15555550100",
  "ext": "",
  "email": "info@acme-dental.example.com",
  "address": "100 Main St",
  "city": "San Diego",
  "state": "CA",
  "zip": "92101",
  "country": "US",
  "type": "prospect",
  "notes": "",
  "primaryContactId": 1042
}
```

## Example request

```bash
curl -X POST 'https://dashboard.vinsi.ai/api/crm/companies' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Acme Dental","industry":"Healthcare","website":"https://acme-dental.example.com","phone":"+15555550100","ext":"","email":"info@acme-dental.example.com","address":"100 Main St","city":"San Diego","state":"CA","zip":"92101","country":"US","type":"prospect","notes":"","primaryContactId":1042}'
```

## Example response

```json
{
  "id": 318,
  "organizationId": "cmexampleorg00000000000001",
  "name": "Acme Dental",
  "industry": "Healthcare",
  "website": "https://acme-dental.example.com",
  "phone": "+15555550100",
  "ext": "",
  "email": "info@acme-dental.example.com",
  "address": "100 Main St",
  "city": "San Diego",
  "state": "CA",
  "zip": "92101",
  "country": "US",
  "type": "prospect",
  "notes": null,
  "ownerId": "cmexampleuser0000000000001",
  "createdAt": "2026-09-01T18:30:00.000Z",
  "updatedAt": "2026-09-01T18:30:00.000Z",
  "primaryContactId": 1042,
  "reviewRating": "",
  "reviewCount": "",
  "logoUrl": null,
  "linkedContactsCount": 1
}
```