---
title: "Update instance communication settings"
method: PATCH
path: "/instance/communication"
tags: ["Instance Settings"]
---

# Update instance communication settings

`PATCH /instance/communication`

Replaces the SMS country blocklist for this instance. Pass the full set of ISO 3166-1
alpha-2 country codes that should be blocked; codes that aren't recognized as SMS-tier
countries are silently dropped from the persisted list. Omitting `blocked_country_codes`
is a no-op.

## Request body

- object
  - `blocked_country_codes` string[], nullable — ISO 3166-1 alpha-2 country codes to block for SMS delivery. Whole-list replacement. Codes must be uppercase, 2-letter, and unique within the array.

## Response `200`

Success

- InstanceCommunication — Per-instance SMS communication settings, including the SMS country blocklist.
  - `object` 'instance_communication', required
  - `blocked_country_codes` string[], required — ISO 3166-1 alpha-2 country codes that are blocked for SMS delivery on this instance. Codes that aren't recognized are silently dropped.

## Other responses

- `422` — Invalid request parameters

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/versions/cf036e7951d3/schema)