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

# Crear una aplicación

> Utiliza este endpoint para crear las credenciales de cliente de una integración máquina a máquina. El nombre de la aplicación identifica el producto o plugin de Lerian al que accederá la integración.



## OpenAPI

````yaml es/openapi/v3-current/AM-identity.yaml post /v1/applications
openapi: 3.1.0
info:
  title: Plugin de identidad
  description: ''
  version: 2.4.5
servers:
  - url: https://identity.sandbox.lerian.net
security: []
tags:
  - name: API de grupos
  - name: API de aplicaciones
  - name: API de usuarios
  - name: API de MFA
  - name: API de proveedores
  - name: API de proveedores de aplicación
paths:
  /v1/applications:
    post:
      tags:
        - API de aplicaciones
      summary: Crear una aplicación
      description: >-
        Utiliza este endpoint para crear las credenciales de cliente de una
        integración máquina a máquina. El nombre de la aplicación identifica el
        producto o plugin de Lerian al que accederá la integración.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApplicationInput'
            example:
              description: Worker de conciliación de Bank Transfer.
              name: bank-transfer-worker
      responses:
        '201':
          description: >-
            Indica que el recurso se creó correctamente y que la operación se
            completó según lo esperado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationResponse'
              example:
                clientId: 019c96a0-6a10-7abc-d1e2-8c9d0e1f2a3b
                clientSecret: 019c96a0-6a20-7bcd-e1f2-9d0e1f2a3b4c
                createdAt: '2021-09-01T00:00:00Z'
                description: Worker de conciliación de Bank Transfer.
                id: 019c96a0-0c0c-7221-8cf3-13313fb60081
                name: bank-transfer-worker
          headers: {}
        '400':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
              examples:
                Error0001:
                  $ref: '#/components/examples/Error0001'
                Error0002:
                  $ref: '#/components/examples/Error0002'
                Error0004:
                  $ref: '#/components/examples/Error0004'
                Error0007:
                  $ref: '#/components/examples/Error0007'
                Error0012:
                  $ref: '#/components/examples/Error0012'
          headers: {}
        '500':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
              examples:
                Error0006:
                  $ref: '#/components/examples/Error0006'
          headers: {}
      security:
        - bearer: []
components:
  schemas:
    ApplicationInput:
      description: Información utilizada para crear una aplicación máquina a máquina.
      type: object
      required:
        - description
        - name
      properties:
        description:
          description: >-
            Identificador claro que te ayuda a reconocer rápidamente qué
            servicio, trabajo o integración usa la aplicación.
          type: string
        name:
          type: string
          description: >-
            El producto o plugin de Lerian al que accederá esta aplicación
            máquina a máquina.
    ApplicationResponse:
      description: Información sobre la aplicación.
      type: object
      properties:
        clientId:
          type: string
          description: Identificador único del cliente.
        clientSecret:
          type: string
          description: >-
            Clave secreta vinculada al `clientId`, utilizada para la
            autenticación segura del cliente.
        createdAt:
          type: string
          format: date-time
          description: Marca de tiempo que indica cuándo se creó la aplicación.
        description:
          description: >-
            Identificador claro que te ayuda a reconocer rápidamente qué
            servicio, trabajo o integración usa la aplicación.
          type: string
        id:
          type: string
          description: Identificador único de la aplicación.
        name:
          type: string
          description: >-
            El producto o plugin de Lerian al que puede acceder esta aplicación
            máquina a máquina.
    ErrorMessage:
      description: Mensaje de error devuelto en la respuesta.
      type: object
      properties:
        code:
          type: string
          description: Identificador único y estable del error.
        title:
          type: string
          description: Resumen breve del problema.
        message:
          type: string
          description: Orientación detallada para resolver el error.
  examples:
    Error0001:
      summary: Missing Fields in Request
      value:
        code: IDE-0001
        title: Missing Fields in Request
        message: Your request is missing one or more required fields.
    Error0002:
      summary: Invalid Field Type in Request
      value:
        code: IDE-0002
        title: Invalid Field Type in Request
        message: The provided field type in the request is invalid.
    Error0004:
      summary: Unexpected Fields in the Request
      value:
        code: IDE-0004
        title: Unexpected Fields in the Request
        message: >-
          The request body contains more fields than expected. Please send only
          the allowed fields.
    Error0007:
      summary: Bad Request
      value:
        code: IDE-0007
        title: Bad Request
        message: The server could not understand the request due to malformed syntax.
    Error0012:
      summary: Invalid Application Name
      value:
        code: IDE-0012
        title: Invalid Application Name
        message: The provided application name is invalid.
    Error0006:
      summary: Internal Server Error
      value:
        code: IDE-0006
        title: Internal Server Error
        message: The server encountered an unexpected error. Please try again later.
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: El token de autorización en formato 'Bearer <token>'.

````