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

# Create a company

> Creates a new company with the provided details. Domains and emails are automatically processed and linked.



## OpenAPI

````yaml openapi.json post /v/alpha/companies/create
openapi: 3.1.0
info:
  title: Operate API Documentation
  description: 'API for Operate: A CRM designed for sales, built for founders'
  version: Alpha
servers:
  - url: https://api.operate.so
security:
  - apiKey: []
tags:
  - name: Companies
    description: Manage companies and their associated data
  - name: People
    description: Manage people/contacts and their associated data
  - name: Deals
    description: Manage deals and opportunities
  - name: Feedback
    description: Manage customer feedback and feature requests
  - name: Next Steps
    description: Manage action items and next steps
  - name: Profiles
    description: Manage organization profiles (team members)
paths:
  /v/alpha/companies/create:
    post:
      tags:
        - Companies
      summary: Create a company
      description: >-
        Creates a new company with the provided details. Domains and emails are
        automatically processed and linked.
      operationId: postVAlphaCompaniesCreate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  minLength: 1
                  description: Company name
                  examples:
                    - Acme Inc.
                    - TechCorp
                  type: string
                logo:
                  description: Company logo URL
                  examples:
                    - https://example.com/logo.png
                  type: string
                domain:
                  description: Company domain(s)
                  anyOf:
                    - description: Single domain
                      type: string
                    - description: Multiple domains
                      type: array
                      items:
                        type: string
                emails:
                  description: Company email(s)
                  anyOf:
                    - description: Single email
                      type: string
                    - description: Multiple emails
                      type: array
                      items:
                        type: string
                user_id:
                  description: User ID associated with this company
                  examples:
                    - user_123
                  type: string
                description:
                  description: Company description
                  examples:
                    - A leading technology company specializing in AI solutions
                  type: string
                funding:
                  description: Company funding amount in USD
                  examples:
                    - 1000000
                    - 50000000
                  type: number
                revenue:
                  type: string
                  enum:
                    - ''
                    - 0-1000000
                    - 1000000-10000000
                    - 10000000-50000000
                    - 50000000-100000000
                    - 100000000-500000000
                    - 250000000-500000000
                    - 500000000-1000000000
                    - 1000000000-5000000000
                    - 5000000000-10000000000
                    - 10000000000+
                size:
                  type: string
                  enum:
                    - ''
                    - 1-10
                    - 11-50
                    - 51-250
                    - 251-1000
                    - 1001-5000
                    - 5001-10000
                    - 10001-50000
                    - 50001-100000
                    - 100001+
                foundation_date:
                  description: Company foundation date (ISO 8601 format)
                  examples:
                    - '2010-05-15'
                    - '2015-12-01'
                  type: string
              required:
                - name
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                name:
                  minLength: 1
                  description: Company name
                  examples:
                    - Acme Inc.
                    - TechCorp
                  type: string
                logo:
                  description: Company logo URL
                  examples:
                    - https://example.com/logo.png
                  type: string
                domain:
                  description: Company domain(s)
                  anyOf:
                    - description: Single domain
                      type: string
                    - description: Multiple domains
                      type: array
                      items:
                        type: string
                emails:
                  description: Company email(s)
                  anyOf:
                    - description: Single email
                      type: string
                    - description: Multiple emails
                      type: array
                      items:
                        type: string
                user_id:
                  description: User ID associated with this company
                  examples:
                    - user_123
                  type: string
                description:
                  description: Company description
                  examples:
                    - A leading technology company specializing in AI solutions
                  type: string
                funding:
                  description: Company funding amount in USD
                  examples:
                    - 1000000
                    - 50000000
                  type: number
                revenue:
                  type: string
                  enum:
                    - ''
                    - 0-1000000
                    - 1000000-10000000
                    - 10000000-50000000
                    - 50000000-100000000
                    - 100000000-500000000
                    - 250000000-500000000
                    - 500000000-1000000000
                    - 1000000000-5000000000
                    - 5000000000-10000000000
                    - 10000000000+
                size:
                  type: string
                  enum:
                    - ''
                    - 1-10
                    - 11-50
                    - 51-250
                    - 251-1000
                    - 1001-5000
                    - 5001-10000
                    - 10001-50000
                    - 50001-100000
                    - 100001+
                foundation_date:
                  description: Company foundation date (ISO 8601 format)
                  examples:
                    - '2010-05-15'
                    - '2015-12-01'
                  type: string
              required:
                - name
          multipart/form-data:
            schema:
              type: object
              properties:
                name:
                  minLength: 1
                  description: Company name
                  examples:
                    - Acme Inc.
                    - TechCorp
                  type: string
                logo:
                  description: Company logo URL
                  examples:
                    - https://example.com/logo.png
                  type: string
                domain:
                  description: Company domain(s)
                  anyOf:
                    - description: Single domain
                      type: string
                    - description: Multiple domains
                      type: array
                      items:
                        type: string
                emails:
                  description: Company email(s)
                  anyOf:
                    - description: Single email
                      type: string
                    - description: Multiple emails
                      type: array
                      items:
                        type: string
                user_id:
                  description: User ID associated with this company
                  examples:
                    - user_123
                  type: string
                description:
                  description: Company description
                  examples:
                    - A leading technology company specializing in AI solutions
                  type: string
                funding:
                  description: Company funding amount in USD
                  examples:
                    - 1000000
                    - 50000000
                  type: number
                revenue:
                  type: string
                  enum:
                    - ''
                    - 0-1000000
                    - 1000000-10000000
                    - 10000000-50000000
                    - 50000000-100000000
                    - 100000000-500000000
                    - 250000000-500000000
                    - 500000000-1000000000
                    - 1000000000-5000000000
                    - 5000000000-10000000000
                    - 10000000000+
                size:
                  type: string
                  enum:
                    - ''
                    - 1-10
                    - 11-50
                    - 51-250
                    - 251-1000
                    - 1001-5000
                    - 5001-10000
                    - 10001-50000
                    - 50001-100000
                    - 100001+
                foundation_date:
                  description: Company foundation date (ISO 8601 format)
                  examples:
                    - '2010-05-15'
                    - '2015-12-01'
                  type: string
              required:
                - name
      responses:
        '200':
          description: Successful response
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication. Obtain from your Operate dashboard.

````