---
title: "Get communications settings for a company"
method: GET
path: "/companies/{companyId}/comms/settings"
tags: ["Company Settings"]
---

# Get communications settings for a company

`GET /companies/{companyId}/comms/settings`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/comms/settings`
- Auth: HTTP bearer

## Response `200`

Current comms settings (returns defaults if not yet set)

- CommsSettingsResponse
  - `success` boolean
  - `data` CommsSettings
    - `companyId` string, uuid
    - `preferredChannel` 'email' | 'iMessage' | 'sms' | 'whatsapp' | 'slack' | 'phone_call'
    - `frequency` 'realtime' | 'daily' | 'weekly' | 'biweekly' | 'monthly'
    - `updatedAt` string, date-time

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)