---
title: "Update Outbound Settings"
method: PUT
path: "/settings/outbound"
tags: ["Settings"]
---

# Update Outbound Settings

`PUT /settings/outbound`

Update outbound calling window settings for the customer.

Times are in Eastern Time and start must be < end. The allowed bounds depend
on the customer's developer-only extended calling window setting: 12:00-18:00
ET normally, 08:00-20:00 ET when it is enabled.

## Request body

- UpdateOutboundSettingsRequest — Update outbound calling window settings request model
  - `calling_window_start` string, nullable — Start of calling window in HH:MM format (Eastern Time). Must be >= the customer's minimum allowed start, which depends on their extended calling window flag (12:00 normally, 08:00 when extended).
  - `calling_window_end` string, nullable — End of calling window in HH:MM format (Eastern Time). Must be <= the customer's maximum allowed end, which depends on their extended calling window flag (18:00 normally, 20:00 when extended).

## Response `200`

Successful Response

- OutboundSettingsResponse — Outbound calling window settings response model
  - `calling_window_start` string, required — Start of calling window in HH:MM format (Eastern Time)
  - `calling_window_end` string, required — End of calling window in HH:MM format (Eastern Time)
  - `min_calling_window_start` string, required — Earliest allowed calling window start in HH:MM format (Eastern Time), based on the customer's extended calling window flag
  - `max_calling_window_end` string, required — Latest allowed calling window end in HH:MM format (Eastern Time), based on the customer's extended calling window flag
  - `trigger_fields` TriggerFieldConfig[] — Fields an outbound call trigger supplies for this customer. Read-only here -- edited on the developer settings router.
    - `key` string, required — Key under which the resolved value is stored in trigger_metadata
    - `label` string, required — Human label shown in the UI
    - `type` string, required — Control type: "select", "text" or "qa_list"
    - `options` TriggerFieldOption[] — Allowed values; required for type=select, ignored for type=text and type=qa_list
      - `value` string, required — Value stored in OutboundLead.trigger_metadata
      - `label` string, required — Human label; this is what gets injected into the prompt
  - `call_pacing_enabled` boolean — Whether outbound calls are paced at one per 10 minutes. When false, calls are placed as soon as they are queued. Read-only here -- edited on the developer settings router.
  - `outbound_leads_enabled` boolean — Whether this customer curates a lead list. When false their leads arrive from a trigger, so the lead list, CSV import and manual call queueing are hidden. Read-only here -- edited on the developer settings router.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/4a81645b59f6/schema)