> ## 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.

# Put someone into an automation

> Subscribes the address to the automation's list without asking for confirmation, then puts it on the journey and runs the first actions at once. Works whatever the automation's trigger is, as long as it is running.



## OpenAPI

````yaml /api-reference/openapi.json post /api/v1/automations/{automation}/trigger
openapi: 3.1.0
info:
  title: Lekalao API
  version: 1.0.0
  description: >-
    Everything the interface does, your application can do too. Every call
    carries an API token (Settings → API tokens).
servers:
  - url: https://{host}
    description: Your installation
    variables:
      host:
        default: lekalao.example.com
        description: The domain of your own Lekalao
security:
  - bearer: []
tags:
  - name: Lists
  - name: Subscribers
  - name: Tags
  - name: Segments
  - name: Imports
  - name: Templates
  - name: Campaigns
  - name: Automations
  - name: Transactional e-mails
  - name: Revenue
  - name: Platform
paths:
  /api/v1/automations/{automation}/trigger:
    post:
      tags:
        - Automations
      summary: Put someone into an automation
      description: >-
        Subscribes the address to the automation's list without asking for
        confirmation, then puts it on the journey and runs the first actions at
        once. Works whatever the automation's trigger is, as long as it is
        running.
      operationId: api.automations.trigger
      parameters:
        - name: automation
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: The automation's identifier (uuid).
        - $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: Journey started.
          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: >-
            The automation is not running, or the address is already travelling
            through it.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  started:
                    type: boolean
        '422':
          description: Invalid data or a blocked address.
          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: >-
        Replay a write safely: the same key gives back the first answer for 24
        hours (header Idempotent-Replay: true).
  responses:
    Unauthenticated:
      description: No token, or an invalid or revoked one.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Message'
          example:
            message: Unauthenticated.
    Forbidden:
      description: The token lacks the ability needed, or the team is suspended.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Message'
    NotFound:
      description: Nothing of that uuid in the token's team.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Message'
    TooManyRequests:
      description: >-
        The token's limit is reached. Wait the number of seconds Retry-After
        gives.
      headers:
        X-RateLimit-Limit:
          schema:
            type: integer
          description: Calls allowed per minute for this token.
        X-RateLimit-Remaining:
          schema:
            type: integer
        Retry-After:
          schema:
            type: integer
  schemas:
    ValidationError:
      type: object
      properties:
        message:
          type: string
          example: The email field must be a valid email address.
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
    Message:
      type: object
      properties:
        message:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: >-
        An API token. The "read" ability: GET routes only. "read + write": every
        route.

````