Welcome to Zuora Product Documentation

Explore our rich library of product information

Preferred contact window field reference

This reference provides the allowed values, default, UI location, and applicable API operations for the preferredContactWindow field on the Account object.

The preferredContactWindow field records the time of day a customer prefers to be contacted for outbound communications such as collections calls or renewal outreach. Collections and Customer Success teams can use this field to schedule outreach during a customer's preferred window. The field is optional and defaults to Any when no preference is set.

In the Zuora UI, the field appears as the Preferred Contact Window dropdown in the Basic Information & Contacts section of the Account detail page. Via the REST API, the field is available on the Create an account and Update an account operations.

Table 1. Allowed values for preferredContactWindow
Value Description
Morning The customer prefers to be contacted in the morning.
Afternoon The customer prefers to be contacted in the afternoon.
Evening The customer prefers to be contacted in the evening.
Any No time-of-day preference is specified. This is the default value.
Table 2. API operations that support preferredContactWindow
Operation Method Field access
Create an account (/v1/accounts) POST Writable
Update an account (/v1/accounts/{account-key}) PUT Writable