Bulk create event passes

POST

https://api-v2.test.eldowallet.fr/events/:id/passes/bulk

Processed asynchronously. Returns a bulk operation: track its status and results with GET /bulk-operations/{operationId}.

Good to know

• Each item follows the rules of POST /events/{id}/passes (rows, unique barcode). Up to 5,000 items; forceSync: true runs the operation synchronously and is limited to fewer than 1,000 items (SYNC_EXECUTION_NOT_ALLOWED). webhookUrl is called when the operation completes.

Request

path parameters

• id string required
  Event ID (24-character hexadecimal MongoDB ID).

header parameters

• x-lang string
  Language for responses
  enum: en, frdefault: "en"

Body application/json required

• webhookUrl string
  Optional webhook URL to receive notification when operation completes. Auth headers: append #headers=Authorization:Bearer%20token
  example: https://example.com/webhook#headers=Authorization:Bearer%20token
• forceSync boolean
  Execute synchronously (max 1000 items). If true and items >= 1000, request is rejected.
  default: false
• items object[] required
  Array of event passes to create
  • firstName string required
  • lastName string required
  • email string <email> required
  • phoneNumber string
  • barcode string
  • leftRow string
  • centerRow string
  • rightRow string
  • clientId string

Responses

201

Schema application/json

• operationId string required
  Unique identifier for the bulk operation
  example: 507f1f77bcf86cd799439011
• totalItems number required
  Total number of items in the operation
  example: 100
• successCount number required
  Number of successfully processed items
  example: 95
• failureCount number required
  Number of failed items
  example: 5
• status string required
  Current status of the operation
  enum: pending, processing, completed, failedexample: pending
• operationErrors object[]
  Array of errors for failed items
  • itemId string required
    ID of the item that failed
    example: 507f1f77bcf86cd799439011
  • message string required
    Error message
    example: Client not found
  • code string
    Error code if available
    example: 404:MODEL_NOT_FOUND
• results object[]
  Array of results for successful items
  • itemId string required
    ID of the item
    example: 507f1f77bcf86cd799439011
  • result object
    Result data
• createdAt string <date-time> required
  Timestamp when the operation was created
  example: 2024-01-01T00:00:00.000Z
• completedAt string <date-time>
  Timestamp when the operation was completed
  example: 2024-01-01T00:05:00.000Z

400

VALIDATION_ERROR · INVALID_JSON · CENTER_ROW_IS_REQUIRED · RIGHT_ROW_IS_REQUIRED · LEFT_ROW_IS_REQUIRED

Schema application/json

• message string requiredexample: Promo code already exists
• errorCode string requiredexample: 400:PROMO_CODE_ALREADY_EXISTS
• path string requiredexample: /coupons
• date string <date-time> required
• details object
• validationErrors object[]
  • field stringexample: email
  • message stringexample: email must be an email

401

UNAUTHORIZED

Schema application/json

• message string requiredexample: Promo code already exists
• errorCode string requiredexample: 400:PROMO_CODE_ALREADY_EXISTS
• path string requiredexample: /coupons
• date string <date-time> required
• details object
• validationErrors object[]
  • field stringexample: email
  • message stringexample: email must be an email

403

FORBIDDEN

Schema application/json

• message string requiredexample: Promo code already exists
• errorCode string requiredexample: 400:PROMO_CODE_ALREADY_EXISTS
• path string requiredexample: /coupons
• date string <date-time> required
• details object
• validationErrors object[]
  • field stringexample: email
  • message stringexample: email must be an email

404

MODEL_NOT_FOUND

Schema application/json

• message string requiredexample: Promo code already exists
• errorCode string requiredexample: 400:PROMO_CODE_ALREADY_EXISTS
• path string requiredexample: /coupons
• date string <date-time> required
• details object
• validationErrors object[]
  • field stringexample: email
  • message stringexample: email must be an email

409

BARCODE_ALREADY_EXISTS

Schema application/json

• message string requiredexample: Promo code already exists
• errorCode string requiredexample: 400:PROMO_CODE_ALREADY_EXISTS
• path string requiredexample: /coupons
• date string <date-time> required
• details object
• validationErrors object[]
  • field stringexample: email
  • message stringexample: email must be an email

500

UNKNOWN_ERROR

Schema application/json

• message string requiredexample: Promo code already exists
• errorCode string requiredexample: 400:PROMO_CODE_ALREADY_EXISTS
• path string requiredexample: /coupons
• date string <date-time> required
• details object
• validationErrors object[]
  • field stringexample: email
  • message stringexample: email must be an email