> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Create SOAP Requests

> Create SOAP requests in Zuora by navigating through the Generic API Utility, configuring execution settings, and generating request templates.

Create SOAP requests in Zuora by navigating through the Generic API Utility, configuring execution settings, and generating request templates.

Ensure that the "API Write Access" permission is enabled for your user role in the Zuora tenant.

Navigate to **New Task** > **Generic API Utility**.

In the **General** tab, complete the following settings:

1. Select the timing of execution from the **Execution** drop-down list. The default value is **Onetime**.

   * **Onetime** - The task will be executed immediately when the resource is available.
   * **Scheduled** - The task will be executed on the date and time specified in the schedule builder.
2. Select the login to your Zuora tenant from the **Source** drop-down list or create a new login. Do not select OAuth credentials or create new logins using OAuth because OAuth is not supported by Developer Tools.
3. Select the operation you want to perform from the **Operation** drop-down list.
4. Select the Zuora object on which you want to operate from the **Object** drop-down list.

Click **Generate**. The SOAP request template is then generated in the text box.

Edit the generated template based on your needs.

(Optional) In the **Options** tab, update the XML namespaces, batch size, exported file format, or whether to perform the request as a single transaction in Zuora.

If you selected **Scheduled** for the **Execution** field, complete the scheduler settings in the **Schedule** tab.

1. Select the time zone from the **Timezone** drop-down list. Zuora strongly recommends you to select the same time zone as for your Zuora tenant to avoid payment errors.
2. In the drop-down list next to **Timezone**, select the time frame of the schedule and complete the details of the selected time frame. The **Timezone** field and schedule builder are used to set how frequently the data is synchronized. It is recommended to set a **Daily** schedule and align the timezone to your Zuora tenant, which can align operations and ensure the app displays the latest data. The **Interval** field displays the specified schedules as a Cron expression and needs no further configuration.

   ![](/_fern-img/843e6a76064b7d27e665db365e33751b1e62fce84add7e908a7a4fa1147caefe.webp)

Click **Create Task**.

Alternatively, you can directly paste the ready-to-use SOAP request in the text box and click **Create Task**to make the request.