Welcome to Zuora Product Documentation

Explore our rich library of product information

Configure Upload File as a source

Learn how to configure a meter to use upload event or transaction data files, including guidelines for file formats and size limits.

You can upload the event or transaction data in the form of a file and use that as the source for a custom meter.

Meter volume limits:

API Sandbox Zuora Developer Sandbox Zuora Central Sandbox
Data File Upload
  • File Size: 10 MB (tenant configurable)
  • Rows: 10,000 (tenant configurable)
  • Supported upload formats: CSV, JSON, Parquet, Excel, XML, Avro. The .ndjson extension is not accepted, although NDJSON content can be parsed by the runtime.

The same as API Sandbox

The same as API Sandbox. No environment-specific overrides exist for Central Sandbox.

Production follows the same limits as Central Sandbox.

  • Both maximum file size and maximum rows are configurable per tenant, not per environment.

  • CSV uploads require a header row.

  1. Navigate to Mediation > Meters
  2. Create a Custom meter.
  3. Select Upload File as the source. The Upload File settings page is displayed. Upload File settings
  4. Enter a name for the Upload File.
  5. Click Select to select an Event Definition on the Upload File setting page. You can create or select an existing Event Definition or import an Event Definition.
  6. Click Save to save the Upload File source settings.