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

# Faire entrer quelqu'un dans une automatisation

> Inscrit l'adresse sur la liste de l'automatisation sans demander de confirmation, puis la fait entrer dans le parcours et exécute les premières actions tout de suite. Fonctionne quel que soit le déclencheur de l'automatisation, pourvu qu'elle soit active.



## OpenAPI

````yaml /api-reference/openapi.fr.json post /api/v1/automations/{automation}/trigger
openapi: 3.1.0
info:
  title: API Lekalao
  version: 1.0.0
  description: >-
    Tout ce que fait l'interface, votre application peut le faire aussi. Chaque
    appel porte un jeton d'API (Paramètres → Jetons d'API).
servers:
  - url: https://{host}
    description: Votre installation
    variables:
      host:
        default: lekalao.example.com
        description: Le domaine de votre Lekalao
security:
  - bearer: []
tags:
  - name: Listes
  - name: Abonnés
  - name: Tags
  - name: Segments
  - name: Imports
  - name: Modèles
  - name: Campagnes
  - name: Automatisations
  - name: E-mails transactionnels
  - name: Revenu
  - name: Plateforme
paths:
  /api/v1/automations/{automation}/trigger:
    post:
      tags:
        - Automatisations
      summary: Faire entrer quelqu'un dans une automatisation
      description: >-
        Inscrit l'adresse sur la liste de l'automatisation sans demander de
        confirmation, puis la fait entrer dans le parcours et exécute les
        premières actions tout de suite. Fonctionne quel que soit le déclencheur
        de l'automatisation, pourvu qu'elle soit active.
      operationId: api.automations.trigger
      parameters:
        - name: automation
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: L'identifiant (uuid) de l'automatisation.
        - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - email
              properties:
                email:
                  type: string
                  format: email
                first_name:
                  type:
                    - string
                    - 'null'
                last_name:
                  type:
                    - string
                    - 'null'
            example:
              email: ada@example.com
              first_name: Ada
      responses:
        '201':
          description: Parcours démarré.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  started:
                    type: boolean
              example:
                message: The automation has started.
                started: true
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          description: L'automatisation n'est pas active, ou l'adresse la parcourt déjà.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  started:
                    type: boolean
        '422':
          description: Données invalides ou adresse bloquée.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  parameters:
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      required: false
      schema:
        type: string
        maxLength: 255
      description: >-
        Rejouez une écriture sans risque : la même clé rend la première réponse
        pendant 24 heures (en-tête Idempotent-Replay: true).
  responses:
    Unauthenticated:
      description: Aucun jeton, ou un jeton invalide ou révoqué.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Message'
          example:
            message: Unauthenticated.
    Forbidden:
      description: Le jeton n'a pas l'aptitude requise, ou l'équipe est suspendue.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Message'
    NotFound:
      description: Aucune ressource de ce uuid dans l'équipe du jeton.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Message'
    TooManyRequests:
      description: >-
        Limite du jeton atteinte. Attendez le nombre de secondes indiqué par
        Retry-After.
      headers:
        X-RateLimit-Limit:
          schema:
            type: integer
          description: Appels permis par minute pour ce jeton.
        X-RateLimit-Remaining:
          schema:
            type: integer
        Retry-After:
          schema:
            type: integer
  schemas:
    ValidationError:
      type: object
      properties:
        message:
          type: string
          example: Le champ email doit être une adresse e-mail valide.
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
    Message:
      type: object
      properties:
        message:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: >-
        Jeton d'API. Aptitude « read » : routes GET seulement. « read + write »
        : toutes les routes.

````