Welcome to Zuora Product Documentation

Explore our rich library of product information

Mediation: Send Events

This reference explains the Mediation: Send Events task.

Use the Mediation: Send Events task to send event data from a workflow to a Mediation meter. The task supports the following integration types:

  • API – Calls the Mediation ingest usage events API.

You can select a Mediation meter and send a JSON payload through the ingest API (API type).

API integration type

When Integration Type is set to API, the task:

  • Uses the selected meter as the GlobalMeterId path parameter in the Mediation ingest usage events API.

  • Sends the JSON body you configure in the task as the request body. The JSON body format is the same as the one used in the Workflow Callout task for the same ingest endpoint.

  • Calls the Mediation APIs internally using configured Zuora credentials. No Mediation-specific credentials are configured on this task.

Ensure that the JSON body is formatted and populated correctly according to the Mediation ingest usage events API.

Task settings

  • Integration Type (required) - Select how Workflow sends events to Mediation:

    • API – Sends events using the Mediation ingest usage events API.

  • Meter (required) - The Mediation meter that should receive the events.

    • The field displays a dropdown of Mediation meters with the meter name and ID in each row (for example, "Usage Royalty Event (ID: 3)").

    • You can also enter a meter ID using free text.

    • Only the meter ID is used and stored; meter versions are not configured on this task.

  • JSON body (required for API integration type) - The request body sent to the Mediation ingest usage events API. This field is applicable only when Integration Type is set to API.

    • The structure of this JSON body is the same as the body used by the Workflow Callout task when calling the same ingest endpoint.

    • Ensure that the JSON body is formatted and populated correctly according to the Mediation ingest usage events API.