Welcome to Zuora Product Documentation

Explore our rich library of product information

Configure a HTTP processor

Learn how to configure an HTTP processor to enable real-time data enrichment by calling external APIs within a mediation flow.

  1. Navigate to Mediation > Meters.
  2. Create a Custom meter.
  3. Select and drag the HTTP processor type on to the meter stream page.
  4. In the HTTP settings page, enter a Name for the processor.
    A unique Operator ID for this processor component is displayed. This unique ID is used for event logging. You can copy this ID to be used in external applications.
    HTTP processor settings
  5. From the Method drop-down list, select the method to be used for the API call.
  6. Select the Connection to be used to access the resource.
    When configuring the HTTP Operator, you must select an existing connection from the Connection dropdown list. This connection defines the base URL, authentication, and headers used in your HTTP requests. Use the Manage Connections button under Mediation > Meters to create a connection.
  7. If needed, you can enter the Path to the specific resource.
    You can use variables in this path.
    https://api.partner.com/{{event.customerId}}
  8. Click the Headers tab to specify the key value pairs which will be sent as a part of the API call.
  9. Click + Add Field and specify a Key and Value for each header.
    Content-Type and application/json.
  10. Click the Params tab to specify the query and path parameters.
  11. Click + Add Field and specify a Key and Value for each parameter.
  12. Click the Body tab and paste the request body.
    You can use nested JSON or plain text payloads.
  13. Click the Response tab and paste the code for a sample API response.
  14. Below the sample response, map each Source Field from the response to the corresponding Target Field in the event, to be enriched.
  15. Click Advanced Settings to configure the timeout value (in milliseconds) and to specify the number of times the API call should be retried, if the initial attempt fails.
    The default timeout value is set to 30000 milliseconds.
  16. If you want to pipeline processing to continue even if the HTTP call fails, select the Pass on event in case of error check box.
  17. After configuring the processor, click Save.