--- title: "Guía de la API para operadores" slug: "using-the-operator-api" updated: 2026-10-22T14:33:53Z published: 2026-10-22T14:33:53Z canonical: "support.tulip.co/using-the-operator-api" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Guía de la API para operadores *Descubre cómo configurar la API para operadores* Advanced Content This article assumes previous experience with APIs. Es necesario añadir operadores a tu sitio para completar la lista de usuarios que ejecutarán las aplicaciones desarrolladas en Tulip. Puedes crear operadores de dos maneras:* [En la página «Usuarios»](https://support.tulip.co/docs/adding-users-and-managing-user-roles), situada en **«Configuración»*** Utilizando un sistema externo a través de la API de Tulip. El procedimiento que se muestra a continuación explica cómo utilizar la API de Tulip para crear operadores. ## Añadir un token de la API de operadores Feature rename Prior to r383, Service Accounts were called "API Tokens". En tu instancia de Tulip, haz clic en **el icono** de tu **perfil** situado en la esquina superior derecha y selecciona **«Configuración**». ![Configuring Your Tulip Account Settings_124925135](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Configuring%20Your%20Tulip%20Account%20Settings_124925135.png) Selecciona **«API de Tulip»** y, a continuación, haz clic en el botón **«Crear cuenta de servicio** » situado en la esquina superior derecha. ![Create%20API%20token1](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Create%20API%20token1.png) En el menú de creación, asigna un **nombre** al token de la API y selecciona el ámbito `«users:write` ». Haz clic en **«Crear**». ![Create API Token](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Create%20API%20Token.gif) Note Make sure to save the Service Account information for the **API Key**, **Secret**, and **Authorization Header**. ## Uso de la API de operador A continuación se explica cómo crear un operador. En este caso, el ejemplo utilizará [Postman](https://www.postman.com/) para llevar a cabo la creación. En primer lugar, añade tu punto final de la API a la solicitud POST. NOTE If you are using a global API key, you need to specify the workspace. If your API key is workspaced scoped, it is optional. *https://(nombrede tuinstanciaquí).tulip.co/api/v3/w/(espacio de trabajo)/users* ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222496924.png) A continuación, en «Autorización», selecciona **«Autenticación básica»** e introduce la clave de la API como **nombre de usuario** y el secreto de la API como **contraseña**. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222497720.png) En «Headers», añade el **encabezado «Auth**». ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222497957.png) En el «Cuerpo», configura la solicitud para que incluya el objeto JSON. El formato genérico de esta solicitud es el siguiente: `{"role": "operator","name": "string","badge_id": "string"}` El resultado tendrá un aspecto similar a este: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222499033.png) Haz clic en **«Enviar»** para ejecutar la solicitud y recibirás una respuesta 201 que indica que se ha realizado correctamente. Para verificarlo, puedes consultar tu lista de usuarios en **«Configuración»** y confirmar que el usuario se ha creado correctamente. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Operator%20API_222499593.png) Si la solicitud ha fallado, comprueba que la clave y el secreto sean correctos. Para obtener más información sobre códigos de respuesta específicos, consulta [Introducción a las API](/r230/docs/introduction-to-apis). --- ¿Has encontrado lo que buscabas? ¡También puedes visitar [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) para publicar tu pregunta o ver si otros usuarios se han encontrado con un problema similar! **JSON** **JSON (JavaScript Object Notation)** is a light-weight, text-based data format that is used to store and transfer data.