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

# Create Entity

> Creates a new Entity and initiates the verification flow. The response includes links that the Entity can use to complete identity verification (KYC for individuals, KYB for businesses) and accept the terms of service.



## OpenAPI

````yaml POST /entities
openapi: 3.1.0
info:
  title: Otim Platform API
  version: v0
  description: >-
    API for managing accounts, entities, transfers, counterparties, and IBANs on
    the Otim platform.
servers:
  - url: https://api.otim.com/v0
security:
  - bearerAuth: []
paths:
  /entities:
    post:
      tags: []
      summary: Create Entity
      description: >-
        Creates a new Entity and initiates the verification flow. The response
        includes links that the Entity can use to complete identity verification
        (KYC for individuals, KYB for businesses) and accept the terms of
        service.
      operationId: createEntity
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateEntityRequest'
      responses:
        '201':
          description: Entity created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateEntityResponse'
        '400':
          description: Validation error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    CreateEntityRequest:
      type: object
      required:
        - email
        - type
      properties:
        email:
          type: string
          format: email
          description: Email address for the Entity.
        type:
          type: string
          enum:
            - individual
            - business
          description: The type of Entity.
        fullName:
          type: string
          description: Full name of the individual. Required when type is `individual`.
        businessName:
          type: string
          description: Name of the business. Required when type is `business`.
    CreateEntityResponse:
      type: object
      properties:
        id:
          type: string
          example: ent_01JA1B2C3D4E5F6G7H8J9K0L
        email:
          type: string
          format: email
        type:
          type: string
          enum:
            - individual
            - business
        kycStatus:
          type: string
          example: not_started
        tosStatus:
          type: string
          example: not_started
        kycLink:
          type: string
          description: Share this link with the Entity to begin identity verification.
          example: https://verify.otim.com/kyc/abc123
        tosLink:
          type: string
          description: Share this link with the Entity to accept terms of service.
          example: https://verify.otim.com/tos/abc123
        createdAt:
          type: string
          format: date-time
    Error:
      type: object
      properties:
        error:
          type: string
        code:
          type: string
          description: A machine-readable error code.
        details:
          type: object
          nullable: true
          description: Additional context about the error.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key prefixed with `sk_`.

````