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

# Create Tenant

> Create Tenant



## OpenAPI

````yaml openapi/billing.yaml post /v1
openapi: 3.0.1
info:
  title: Billing API
  description: ''
  version: '1.0'
servers:
  - url: https://apigw.ipxo.com/billing
security:
  - bearerAuth: []
paths:
  /v1:
    post:
      tags:
        - Tenants
      summary: Create Tenant
      description: Create Tenant
      operationId: API-Pub-Tenants-Create
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/API.Pub.Requests.Tenants.StoreTenantRequest'
            example:
              title: string
              email: string
              business_since: string
              company_size: string
              address1: string
              address2: string
              city: string
              country: string
              postcode: string
              state: string
              abuse_email: string
              vat_number: string
              industry_uuid: string
              reuse_address: true
              options:
                website: string
                social_network:
                  - string
                has_social_network: true
                found_us: string
                primary_intention: string
                proprata: true
                prorata_day: 0
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/API.Pub.Resources.Tenants.TenantResource'
              example:
                uuid: string
                email: string
                business_since: string
                company_size: string
                title: string
                status: string
                code: string
                options:
                  - key: string
                    value: {}
                meta:
                  - key: string
                    value: string
                credit:
                  amount: 0
                  auto_payment: true
                summary: string
                logo:
                  image: string
                payment_gateways:
                  - string
                flags:
                  - uuid: string
                    slug: string
                status_reason:
                  uuid: string
                  slug: string
                  title: string
                vat_number: string
                vat_validated_at: string
                vat_validation_status: valid
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '422':
          description: Unprocessable Entity
components:
  schemas:
    API.Pub.Requests.Tenants.StoreTenantRequest:
      required:
        - title
        - email
        - address1
        - city
        - country
        - postcode
        - state
        - abuse_email
        - company_size
        - business_since
      type: object
      properties:
        title:
          type: string
        email:
          type: string
        business_since:
          type: string
        company_size:
          type: string
        address1:
          type: string
        address2:
          type: string
        city:
          type: string
        country:
          type: string
        postcode:
          type: string
        state:
          type: string
        abuse_email:
          type: string
        vat_number:
          type: string
        industry_uuid:
          type: string
          format: uuid
        reuse_address:
          type: boolean
        options:
          type: object
          properties:
            website:
              type: string
            social_network:
              type: array
              items:
                type: string
            has_social_network:
              type: boolean
            found_us:
              type: string
            primary_intention:
              type: string
            proprata:
              type: boolean
            prorata_day:
              type: integer
              description: Tenant Option Prorata Day
    API.Pub.Resources.Tenants.TenantResource:
      type: object
      properties:
        uuid:
          type: string
        email:
          type: string
        business_since:
          type: string
          nullable: true
        company_size:
          type: string
          nullable: true
        title:
          type: string
        status:
          type: string
        code:
          type: string
        options:
          type: array
          items:
            $ref: '#/components/schemas/API.Pub.Resources.Tenants.OptionResource'
        meta:
          type: array
          items:
            $ref: '#/components/schemas/API.Pub.Resources.Tenants.MetadataResource'
        credit:
          type: object
          properties:
            amount:
              type: number
              format: float
            auto_payment:
              type: boolean
        summary:
          type: string
        logo:
          $ref: '#/components/schemas/API.Pub.Resources.Tenants.TenantLogoResource'
        payment_gateways:
          type: array
          items:
            type: string
        flags:
          type: array
          items:
            $ref: '#/components/schemas/API.Pub.Resources.Tenants.TenantFlagResource'
        status_reason:
          $ref: '#/components/schemas/API.Pub.Resources.Tenants.StatusReasonResource'
        vat_number:
          type: string
        vat_validated_at:
          type: string
          nullable: true
        vat_validation_status:
          enum:
            - valid
            - invalid
            - failed
          type: string
          nullable: true
    API.Pub.Resources.Tenants.OptionResource:
      type: object
      properties:
        key:
          type: string
        value:
          oneOf:
            - type: string
            - type: array
              items:
                type: string
    API.Pub.Resources.Tenants.MetadataResource:
      type: object
      properties:
        key:
          type: string
        value:
          type: string
    API.Pub.Resources.Tenants.TenantLogoResource:
      type: object
      properties:
        image:
          type: string
    API.Pub.Resources.Tenants.TenantFlagResource:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        slug:
          type: string
    API.Pub.Resources.Tenants.StatusReasonResource:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        slug:
          type: string
        title:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````