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

# Crear etiqueta

> Crea una etiqueta para clasificar tus asistentes

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Crea una etiqueta para clasificar asistentes entre carpetas (por ejemplo, `inbound` o `outbound`). Aplica etiquetas a los asistentes con el campo `label_ids` en los endpoints [Crear asistente](/es/api-v1/assistants/create) y [Actualizar asistente](/es/api-v1/assistants/update).

### Cuerpo de la solicitud

<ParamField body="name" type="string" required>
  El nombre de la etiqueta (máx. 255 caracteres). Debe ser único dentro de tu cuenta.
</ParamField>

<ParamField body="color" type="string">
  Un color para la insignia de la etiqueta. Uno de: `gray`, `slate`, `red`, `orange`, `amber`, `green`, `teal`, `blue`, `purple`, `pink`.
</ParamField>

### Respuesta

<ResponseField name="message" type="string">Mensaje de éxito</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="propiedades">
    <ResponseField name="id" type="integer">El identificador único de la etiqueta creada</ResponseField>
    <ResponseField name="name" type="string">El nombre de la etiqueta</ResponseField>
    <ResponseField name="color" type="string">El color de la etiqueta (o `null`)</ResponseField>
    <ResponseField name="assistants_count" type="integer">Número de asistentes a los que se aplica esta etiqueta (siempre `0` para una etiqueta nueva)</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 201 Success Response theme={null} theme={null}
  {
    "message": "Label created successfully",
    "data": { "id": 3, "name": "Inbound", "color": "green", "assistants_count": 0 }
  }
  ```

  ```json 422 Validation Error theme={null} theme={null}
  {
    "message": "The name has already been taken.",
    "errors": { "name": ["The name has already been taken."] }
  }
  ```
</ResponseExample>