---
title: "Update the calling extension settings for a specific app."
method: PATCH
path: "/crm/extensions/calling/2026-03/{appId}/settings"
tags: ["Basic"]
---

# Update the calling extension settings for a specific app.

`PATCH /crm/extensions/calling/2026-03/{appId}/settings`

Modify existing calling extension settings for the specified appId. Only the fields provided in the request will be updated.

## Path parameters

- `appId` integer, required

## Request body

- CrmExtensionsCallingSettingsPatchRequest
  - `height` integer — The height setting for the calling extension interface.
  - `isReady` boolean — Specifies whether the calling extension is ready for use.
  - `name` string — The name of the calling extension.
  - `supportsCustomObjects` boolean — Indicates if the calling extension supports custom objects.
  - `supportsInboundCalling` boolean — Indicates if the calling extension supports inbound calling.
  - `url` string — The URL associated with the calling extension settings.
  - `usesCallingWindow` boolean — Indicates if the calling extension uses a calling window.
  - `usesRemote` boolean — Indicates if the calling extension uses a remote connection.
  - `width` integer — The width setting for the calling extension interface.

## Response `200`

successful operation

- CrmExtensionsCallingSettingsResponse
  - `createdAt` string, date-time, required — The date and time when the calling extension settings were created.
  - `height` integer, required — The height of the calling extension interface.
  - `isReady` boolean, required — Specifies whether the calling extension settings are ready for use.
  - `name` string, required — The name of the calling extension.
  - `supportsCustomObjects` boolean, required — Indicates if the calling extension supports custom objects.
  - `supportsInboundCalling` boolean, required — Indicates if the calling extension supports inbound calling.
  - `updatedAt` string, date-time, required — The date and time when the calling extension settings were last updated.
  - `url` string, required — The URL associated with the calling extension.
  - `usesCallingWindow` boolean, required — Specifies if the calling extension uses a dedicated calling window.
  - `usesRemote` boolean, required — Indicates if the calling extension uses a remote service.
  - `width` integer, required — The width of the calling extension interface.

## Other responses

- `default` — An error occurred.

## Changes

> 14 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-04-08** `b0d8bc008db9` — 1 info
  - api operation id `patch-/crm/extensions/calling/2026-03/{appId}/settings_update` removed and replaced with `patch-/crm/extensions/calling/2026-03/{appId}/settings`
- **2026-03-25** `62586336cea2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hubspot/apis/hubspot-api-specification/changes/crm/extensions/calling/2026-03/:appId/settings/patch.md)

---

[API](https://skmtc.dev/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.dev/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/revisions/f9c7181056c5/schema)