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

# Create Organization

> Creates a new organization under the specified vendor.



## OpenAPI

````yaml POST /api/v1/vendors/{vendorId}/organizations
openapi: 3.1.0
info:
  title: Deepslate
  description: OpenAPI specification of the public Deepslate API
  version: v1.0
servers:
  - url: https://app.deepslate.eu
    description: Generated server url
security: []
tags:
  - name: SIP Credentials Management
    description: API endpoints for managing SIP Credentials within an Organization
  - name: Assistant Management
    description: API endpoints for managing Assistants within an Organization
  - name: SIP Numbers Management
    description: API endpoints for managing SIP Numbers within an Organization
  - name: Agent Task Management
    description: API endpoints for retrieving Agent Tasks
  - name: Organization Management
    description: API endpoints for managing Organizations
  - name: Agent Management
    description: API endpoints for managing Agents within an Organization
  - name: LLM Generation Strategy Management
    description: >-
      API endpoints for managing LLM Generation Strategies within an
      Organization
paths:
  /api/v1/vendors/{vendorId}/organizations:
    post:
      tags:
        - Organization Management
      summary: Create Organization
      description: Creates a new organization under the specified vendor.
      operationId: createOrganization
      parameters:
        - name: vendorId
          in: path
          description: ID of the Vendor (UUID)
          required: true
          schema:
            type: string
          example: a1b2c3d4-e5f6-7890-1234-567890abcdef
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OrganizationCreate'
        required: true
      responses:
        '200':
          description: Organization successfully created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmptyResponse'
        '400':
          description: Bad Request - Invalid input data
        '401':
          description: Unauthorized
        '403':
          description: >-
            Forbidden - User does not have permission to create organizations
            for this vendor
        '404':
          description: Vendor or Plan not found
components:
  schemas:
    OrganizationCreate:
      type: object
      description: Data required to create a new Organization.
      properties:
        companyName:
          type: string
          description: Name of the organization.
          example: Example Corp
        industry:
          type: string
          description: Industry the organization operates in.
          example: Technology
        contact:
          $ref: '#/components/schemas/OrganizationCreateContact'
          description: Primary contact information for the organization.
        planId:
          type: string
          description: ID of the Plan assigned to this organization (UUID).
          example: c4a9e3f8-a3b2-4d1c-8b7e-5a9f0d1e2c3b
      required:
        - companyName
        - contact
        - industry
        - planId
    EmptyResponse:
      type: object
      description: Standard API response wrapper
      properties:
        success:
          type: boolean
          description: Indicates if the request was successful
          example: true
        message:
          type: string
          description: Human-readable message
        data:
          description: Payload data object
          example: null
        timestamp:
          type: string
          format: date-time
          description: Response timestamp in ISO-8601 format
          example: '2025-04-17T14:23:30Z'
        traceId:
          type: string
          description: Correlation or trace ID
      required:
        - success
        - timestamp
    OrganizationCreateContact:
      type: object
      description: Contact person details.
      properties:
        firstName:
          type: string
          description: First name of the contact.
          example: Jane
        lastName:
          type: string
          description: Last name of the contact.
          example: Doe
        phoneNumber:
          type: string
          description: Contact phone number (preferably E.164 format).
          example: '+491701234567'
        country:
          type: string
          description: Country code of the contact (ISO 3166-1 alpha-2).
          example: DE
      required:
        - country
        - firstName
        - lastName
        - phoneNumber

````