---
title: "Import a meter definition"
method: POST
path: "/meters/import"
tags: ["Meters"]
---

# Import a meter definition

`POST /meters/import`

Import a meter definition into Zuora Mediation using a file exported from the Export Meter API.

## Headers

- `Content-Type` string, required
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Track-Id` string

## Response `200`

Successful import of meter definition

- ImportMeterResponse
  - `success` boolean
  - `data` object
    - `id` string — Internal meter ID, unique within tenant
    - `name` string — Meter name
    - `description` string — Meter description
    - `type` string — Meter type
    - `typeDefinition` MeterTypeDefinition
      - `sourceType` string — Source type, e.g., ZUORA_BULK_API or LOCAL_FILE
      - `schemaId` string — Event definition ID
      - `fieldMappings` UsageFieldMapping[] — Field mappings from event definition to Zuora usage
        - `name` string — Field name
        - `field` string — Mapped field name
        - `required` boolean — Indicates if the field is required
        - `dateFormat` string — Date format if applicable
      - `configs` object — Configurations for accumulated meters (e.g., SUM)
    - `latestVersion` string — The latest version of the meter
    - `globalId` string — Meter global ID used for ingestion via Streaming API
    - `uniqueUploadUrl` string — The upload URL for usage ingestion
    - `activeVersionRunStatus` integer — Run status of the active version
    - `activeVersionRunStatusDescription` string — Description of active version run status
    - `latestVersionRunStatus` integer — Run status of the latest version
    - `latestVersionRunStatusDescription` string — Description of latest version run status
    - `createdAt` string — Timestamp of meter creation
    - `updatedAt` string — Timestamp of meter update

## Other responses

- `400` — Invalid request
- `401` — Unauthorized access
- `500` — Internal server error

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)