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

# Crear una definición de rastreador externo en el catálogo de la empresa

> La empresa y el creador se resuelven del lado del servidor a partir de la clave del llamante. Los nombres de tracker son únicos por empresa.



## OpenAPI

````yaml /openapi-v1.es.json post /v1/external-trackers
openapi: 3.0.0
info:
  title: Woku Client API v1
  description: >-
    API REST pública para la administración programática de programas
    Voice-of-Customer de woku: trackers, instrumentos VoC (NPS, woku, CES,
    CSAT), planes de acción, tickets de soporte, envío multicanal y captura de
    respuestas. Las solicitudes están delimitadas por empresa mediante la clave
    API. Nunca envíe un id de empresa.
  version: 1.0.0
  contact:
    name: Woku
    url: https://woku.app
    email: team@woku.app
servers:
  - url: https://clientapi.woku.app
    description: Producción
security: []
tags: []
paths:
  /v1/external-trackers:
    post:
      tags:
        - v1 - external-trackers
      summary: Crear una definición de rastreador externo en el catálogo de la empresa
      description: >-
        La empresa y el creador se resuelven del lado del servidor a partir de
        la clave del llamante. Los nombres de tracker son únicos por empresa.
      operationId: ExternalTrackersController_createTracker
      parameters:
        - name: X-Woku-Idempotency-Key
          in: header
          description: >-
            Clave generada por el cliente para hacer que la creación sea segura
            para reintentar. Un reintento con la misma clave devuelve el
            resultado original en lugar de crear de nuevo.
          required: false
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateExternalTrackerDefinitionDTO'
      responses:
        '201':
          description: Definición de tracker creada
        '403':
          description: Clave de API inválida o ausente
        '409':
          description: Nombre del tracker ya en uso
      security:
        - bearer: []
components:
  schemas:
    CreateExternalTrackerDefinitionDTO:
      type: object
      properties:
        name:
          type: string
          description: >-
            Nombre del tracker. Identifica el tracker dentro del catálogo de la
            empresa. Único por empresa.
          example: trr
          minLength: 1
          maxLength: 60
        system:
          type: string
          description: Sistema externo al que se asigna este rastreador.
          example: crm interno
          maxLength: 80
        description:
          type: string
          description: Descripción legible para humanos del rastreador.
          example: transaction id of a lease or sale
          maxLength: 500
      required:
        - name
        - system
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: API key
      type: http
      description: Clave API secreta de la empresa.

````