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

# Send Events Batch Job

> Track multiple user actions or multiple actions for a single user in a single API call for efficient event tracking and analytics.

## Send Events Batch Job

Bulk event processing for efficient event tracking and analytics. This endpoint allows you to track multiple user actions or multiple actions for a single user in a single batch operation, improving performance and reducing network overhead.

<Info>
  **Security:** Requires **apiKey** and **secretKey** headers.
</Info>


## OpenAPI

````yaml POST /api/v4.0/integrations/batch/events
openapi: 3.1.0
info:
  title: Gameball API
  description: >-
    Gameball REST API v4.0 - Complete API reference for integrating loyalty,
    gamification, and customer engagement features
  version: 4.0.0
servers:
  - url: https://api.gameball.co
security:
  - bearerAuth: []
paths:
  /api/v4.0/integrations/batch/events:
    post:
      description: >-
        Track multiple user actions or multiple actions for a single user in a
        single API call for efficient event tracking and analytics.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                body:
                  type: array
                  items:
                    type: object
                    required:
                      - customerId
                      - events
                    properties:
                      customerId:
                        type: string
                        description: Unique identifier for the customer.
                      events:
                        type: object
                        description: >-
                          Object containing event names as keys and their
                          metadata as values.
                        additionalProperties:
                          type: object
                          description: >-
                            Event metadata containing relevant attributes for
                            the event.
      responses:
        '200':
          description: Batch event processing initiated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  jobId:
                    type: number
                    description: >-
                      The assigned job ID, which is later used for status
                      verification and response retrieval.
      security:
        - apiKey: []
          secretKey: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKey:
      type: apiKey
      in: header
      name: apikey
    secretKey:
      type: apiKey
      in: header
      name: secretkey

````