> ## Documentation Index
> Fetch the complete documentation index at: https://guide.rolodexcrm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Company

## `POST`a company

`POST` `/user-api/v1/companies`

### Headers

| **Header**          | **Value**           |
| ------------------- | ------------------- |
| `Content-Type`      | `application/json`  |
| `x-rolodex-api-key` | `f1e2d3c4b5a697...` |

### Required Fields

<ParamField path="name" type="string">
  Company name
</ParamField>

### Request

```json theme={null}
{
  "name": "TechStart Inc",
  "description": "Innovative startup focused on AI solutions",
  "headquarters_location": "Austin, TX",
  "linkedin_slug": "techstart-inc",
  "website_url": "https://techstart.com",
  "email": "hello@techstart.com",
  "country_code": "+1",
  "phone_number": "5559876543",
  "arr_estimate": 1200000,
  "number_of_employees": 45,
  "is_starred": true,
  "tags": ["tag_123", "tag_456"],
  "lists": ["list_789"],
  "contacts": ["contact_101"],
  "custom_fields": [
    {
      "id": "field_123",
      "value": "Artificial Intelligence"
    },
    {
      "id": "field_456",
      "value": "option_789"
    }
  ]
}
```

### Response

```json theme={null}
{
  "data": {
    "id": "company_67890",
    "name": "TechStart Inc",
    "description": "Innovative startup focused on AI solutions",
    "headquarters_location": "Austin, TX",
    "linkedin_slug": "techstart-inc",
    "website_url": "https://techstart.com",
    "x_slug": null,
    "facebook_slug": null,
    "instagram_slug": null,
    "email": "hello@techstart.com",
    "country_code": "+1",
    "phone_number": "5559876543",
    "arr_estimate": 1200000,
    "number_of_employees": 45,
    "is_starred": true,
    "ignore_merge": false,
    "last_team_interaction": null,
    "team_members_connected": 0,
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:30:00Z",
    "tags": [
      {
        "tag": {
          "id": "tag_123",
          "name": "Startup"
        }
      },
      {
        "tag": {
          "id": "tag_456",
          "name": "AI"
        }
      }
    ],
    "lists": [
      {
        "list": {
          "id": "list_789",
          "name": "Q1 Prospects"
        }
      }
    ],
    "contacts": [
      {
        "id": "contact_101",
        "full_name": "Sarah Johnson",
        "image_url": null
      }
    ],
    "custom_fields": [
      {
        "id": "field_123",
        "name": "Industry Vertical",
        "field_type": "SINGLE_LINE_TEXT",
        "value": "Artificial Intelligence"
      },
      {
        "id": "field_456",
        "name": "Stage",
        "field_type": "SINGLE_SELECT",
        "value": {
          "id": "option_789",
          "value": "Growth"
        }
      }
    ]
  }
}
```