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

# Créer une étiquette

> Créez une nouvelle étiquette WhatsApp

### Endpoint

<ParamField method="POST" path="/v1/whatsapp/labels" />

### Body Parameters

<ParamField body="accountId" type="string" required>
  Identifiant du compte WhatsApp.
</ParamField>

<ParamField body="name" type="string" required>
  Nom de l’étiquette. Si une étiquette active porte déjà ce nom, elle est retournée au lieu d’être recréée.
</ParamField>

<ParamField body="color" type="integer">
  Identifiant de couleur WhatsApp. La valeur par défaut est `0`.
</ParamField>

<ParamField body="labelId" type="string">
  Identifiant personnalisé. WaChap génère un identifiant unique lorsqu’il est omis.
</ParamField>

### Exemple

```bash theme={null}
curl -X POST https://api.wachap.com/v1/whatsapp/labels \
  -H "Authorization: Bearer token" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "account_123",
    "name": "VIP",
    "color": 1
  }'
```

### Réponse

```json theme={null}
{
  "success": true,
  "label": {
    "accountId": "account_123",
    "labelId": "label_vip",
    "name": "VIP",
    "color": 1,
    "deleted": false,
    "source": "api"
  }
}
```


## OpenAPI

````yaml POST /whatsapp/labels
openapi: 3.0.3
info:
  title: WaChap API
  version: 2.0.0
servers:
  - url: https://api.wachap.com/v1
    description: WaChap API server
security:
  - BearerAuth: []
tags:
  - name: Instances
    description: Créer et gérer des instances WhatsApp
  - name: Webhook
    description: Configuration des webhooks de réception
  - name: Messages
    description: Envoyer des messages WhatsApp
  - name: Comptes
    description: Gérer vos comptes WhatsApp connectés
  - name: SMS
    description: Service SMS de WaChap (V4) via FCM
  - name: Étiquettes WhatsApp
    description: Créer et associer des étiquettes aux conversations WhatsApp
paths:
  /whatsapp/labels:
    post:
      tags:
        - Étiquettes WhatsApp
      summary: Créer une étiquette WhatsApp
      description: >-
        Crée une étiquette ou retourne l’étiquette active qui porte déjà le même
        nom.
      operationId: createWhatsAppLabel
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - accountId
                - name
              properties:
                accountId:
                  type: string
                name:
                  type: string
                color:
                  type: integer
                  default: 0
                labelId:
                  type: string
            example:
              accountId: account_123
              name: VIP
              color: 1
      responses:
        '200':
          description: Étiquette créée ou existante
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  label:
                    $ref: '#/components/schemas/WhatsAppLabel'
        '400':
          description: Paramètres invalides ou compte WhatsApp indisponible
components:
  schemas:
    WhatsAppLabel:
      type: object
      properties:
        id:
          type: string
        userId:
          type: string
        accountId:
          type: string
        labelId:
          type: string
        name:
          type: string
        color:
          type: integer
        deleted:
          type: boolean
        createdAt:
          type: string
        updatedAt:
          type: string
        syncedAt:
          type: string
        fromSync:
          type: boolean
        source:
          type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````