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

# Start batch journey executions

> Queue multiple journey executions for a single journey. Each contact is processed independently.



## OpenAPI

````yaml post /journey_execution/batch
openapi: 3.1.0
info:
  title: Mateo API
  description: The official API for Mateo
  version: 1.0.0
servers:
  - url: https://integration.getmateo.com/api/v1
security:
  - bearerAuth: []
externalDocs:
  description: Documentation for Mateo API
  url: https://docs.getmateo.com
paths:
  /journey_execution/batch:
    post:
      tags:
        - Journey Execution
      summary: Start batch journey executions
      description: >-
        Queue multiple journey executions for a single journey. Each contact is
        processed independently.
      operationId: postBatch
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                journey_id:
                  type: string
                  format: uuid
                  pattern: >-
                    ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                  description: The journey ID to execute
                items:
                  maxItems: 500
                  type: array
                  items:
                    type: object
                    properties:
                      deduplication_id:
                        type: string
                        description: Unique ID to prevent duplicate processing
                      contact:
                        type: object
                        properties:
                          address_line1:
                            anyOf:
                              - type: string
                              - type: 'null'
                          address_line2:
                            anyOf:
                              - type: string
                              - type: 'null'
                          birthday:
                            anyOf:
                              - type: string
                              - type: 'null'
                          campaign_messages_this_month:
                            type: number
                          city:
                            anyOf:
                              - type: string
                              - type: 'null'
                          country:
                            anyOf:
                              - type: string
                              - type: 'null'
                          created_at:
                            type: string
                          created_by:
                            anyOf:
                              - type: string
                              - type: 'null'
                          created_by_api_token_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          created_by_employee_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          created_by_import_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          created_by_rule_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          deleted_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          description:
                            anyOf:
                              - type: string
                              - type: 'null'
                          display_name:
                            anyOf:
                              - type: string
                              - type: 'null'
                          email:
                            anyOf:
                              - type: string
                              - type: 'null'
                          email_health:
                            anyOf:
                              - type: string
                                enum:
                                  - healthy
                                  - unhealthy
                                  - unknown
                              - type: 'null'
                          email_marketing_messages_this_month:
                            type: number
                          email_marketing_opt_in:
                            type: boolean
                          email_transactional_opt_in:
                            anyOf:
                              - type: string
                                enum:
                                  - legitimate_interest
                                  - contract_fulfillment
                                  - consent_granted
                              - type: 'null'
                          external_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          facebook:
                            anyOf:
                              - type: string
                              - type: 'null'
                          facebook_health:
                            anyOf:
                              - type: string
                                enum:
                                  - healthy
                                  - unhealthy
                                  - unknown
                              - type: 'null'
                          facebook_marketing_messages_this_month:
                            type: number
                          facebook_marketing_opt_in:
                            type: boolean
                          facebook_transactional_opt_in:
                            anyOf:
                              - type: string
                                enum:
                                  - legitimate_interest
                                  - contract_fulfillment
                                  - consent_granted
                              - type: 'null'
                          fts: {}
                          full_name:
                            anyOf:
                              - type: string
                              - type: 'null'
                          google_business_messaging:
                            anyOf:
                              - type: string
                              - type: 'null'
                          google_business_messaging_health:
                            anyOf:
                              - type: string
                                enum:
                                  - healthy
                                  - unhealthy
                                  - unknown
                              - type: 'null'
                          google_business_messaging_marketing_messages_this_month:
                            type: number
                          google_business_messaging_marketing_opt_in:
                            type: boolean
                          google_business_messaging_transactional_opt_in:
                            anyOf:
                              - type: string
                                enum:
                                  - legitimate_interest
                                  - contract_fulfillment
                                  - consent_granted
                              - type: 'null'
                          id:
                            type: string
                          influenced_revenue:
                            type: number
                          instagram:
                            anyOf:
                              - type: string
                              - type: 'null'
                          instagram_health:
                            anyOf:
                              - type: string
                                enum:
                                  - healthy
                                  - unhealthy
                                  - unknown
                              - type: 'null'
                          instagram_marketing_messages_this_month:
                            type: number
                          instagram_marketing_opt_in:
                            type: boolean
                          instagram_transactional_opt_in:
                            anyOf:
                              - type: string
                                enum:
                                  - legitimate_interest
                                  - contract_fulfillment
                                  - consent_granted
                              - type: 'null'
                          is_blocked:
                            type: boolean
                          last_external_review_rating:
                            anyOf:
                              - type: number
                              - type: 'null'
                          last_interaction_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          last_internal_review_rating:
                            anyOf:
                              - type: number
                              - type: 'null'
                          last_outbound_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          last_review_rating:
                            anyOf:
                              - type: number
                              - type: 'null'
                          latest_marketing_opt_in_request_sent_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          latest_review_request_message_sent_at:
                            anyOf:
                              - type: string
                              - type: 'null'
                          marketing_opt_in:
                            anyOf:
                              - type: boolean
                              - type: 'null'
                          number_of_marketing_opt_in_requests:
                            type: number
                          organisation_id:
                            type: string
                          postal:
                            anyOf:
                              - type: string
                              - type: 'null'
                          postal_health:
                            anyOf:
                              - type: string
                                enum:
                                  - healthy
                                  - unhealthy
                                  - unknown
                              - type: 'null'
                          postal_marketing_messages_this_month:
                            anyOf:
                              - type: number
                              - type: 'null'
                          postal_marketing_opt_in:
                            type: boolean
                          postal_messages_this_month:
                            anyOf:
                              - type: number
                              - type: 'null'
                          postal_transactional_opt_in:
                            anyOf:
                              - type: string
                                enum:
                                  - legitimate_interest
                                  - contract_fulfillment
                                  - consent_granted
                              - type: 'null'
                          review_request_message_count:
                            type: number
                          salutation:
                            anyOf:
                              - type: string
                              - type: 'null'
                          secondary_external_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          sms:
                            anyOf:
                              - type: string
                              - type: 'null'
                          sms_health:
                            anyOf:
                              - type: string
                                enum:
                                  - healthy
                                  - unhealthy
                                  - unknown
                              - type: 'null'
                          sms_marketing_messages_this_month:
                            type: number
                          sms_marketing_opt_in:
                            type: boolean
                          sms_transactional_opt_in:
                            anyOf:
                              - type: string
                                enum:
                                  - legitimate_interest
                                  - contract_fulfillment
                                  - consent_granted
                              - type: 'null'
                          transactional_opt_in:
                            anyOf:
                              - type: string
                                enum:
                                  - legitimate_interest
                                  - contract_fulfillment
                                  - consent_granted
                              - type: 'null'
                          updated_at:
                            type: string
                          updated_by:
                            anyOf:
                              - type: string
                              - type: 'null'
                          updated_by_api_token_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          updated_by_employee_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          updated_by_import_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          updated_by_rule_id:
                            anyOf:
                              - type: string
                              - type: 'null'
                          whatsapp:
                            anyOf:
                              - type: string
                              - type: 'null'
                          whatsapp_health:
                            anyOf:
                              - type: string
                                enum:
                                  - healthy
                                  - unhealthy
                                  - unknown
                              - type: 'null'
                          whatsapp_marketing_messages_this_month:
                            type: number
                          whatsapp_marketing_opt_in:
                            type: boolean
                          whatsapp_transactional_opt_in:
                            anyOf:
                              - type: string
                                enum:
                                  - legitimate_interest
                                  - contract_fulfillment
                                  - consent_granted
                              - type: 'null'
                          zipcode:
                            anyOf:
                              - type: string
                              - type: 'null'
                        description: Contact details to import or find
                      context:
                        anyOf:
                          - type: object
                            propertyNames:
                              type: string
                            additionalProperties:
                              type: string
                          - type: 'null'
                        description: >-
                          Context data for this contact, must match the schema
                          defined in the journey trigger node
                    required:
                      - deduplication_id
                      - contact
                  description: Array of contacts to enroll in the journey (max 500)
              required:
                - journey_id
                - items
      responses:
        '202':
          description: Batch queued successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  queued_count:
                    type: number
                required:
                  - success
                  - queued_count
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  hint:
                    type: string
                  statusCode:
                    type: number
                required:
                  - code
                  - message
                  - statusCode
          description: Invalid input or context validation failed
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  hint:
                    type: string
                  statusCode:
                    type: number
                required:
                  - code
                  - message
                  - statusCode
          description: Journey version or trigger node not found
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````