---
title: "uptimeify_organization_settings"
description: "Settings of the token's own organization (one per organization): name, billing address, MFA policy, SMS overage cap and notification defaults for new customers. Only the attributes you set are managed and sent, and only when they differ from the stored value. Creating it adopts the organization; destroying it only removes it from the state, nothing is reset. Plan, quota and payment are not managed here. Import with any id, e.g. org."
---

Settings of the token's own organization (one per organization): name, billing address, MFA policy, SMS overage cap and notification defaults for new customers. Only the attributes you set are managed and sent, and only when they differ from the stored value. Creating it adopts the organization; destroying it only removes it from the state, nothing is reset. Plan, quota and payment are not managed here. Import with any id, e.g. `org`.

## Example Usage

```terraform
# Only the attributes set here are managed; everything else stays as it is.
resource "uptimeify_organization_settings" "this" {
  company_name = "Example GmbH"
  street       = "Hauptstrasse 1"
  postal_code  = "10115"
  city         = "Berlin"
  country      = "Germany"

  default_notification_channels = {
    email        = true
    sms          = false
    webhook      = false
    integrations = true
  }
}
```

## Schema

### Optional

- `billing_email` (String) Address for invoices (admins only). Unset = keep the current value.
- `city` (String) Billing address. Unset = keep the current value.
- `company_name` (String) Company name on invoices. Unset = keep the current value.
- `country` (String) Billing country (free text; the server derives the ISO code). Changing it resets the VAT check. Unset = keep the current value.
- `default_notification_channels` (Attributes) Channels switched on for new customers. Unset = keep. (see [below for nested schema](#nested-schema-for-default_notification_channels))
- `default_notification_targets` (Attributes) Who receives each channel for new customers: `customer`, `organization` or `both` (`webhook`: `organization` only). Unset = keep. (see [below for nested schema](#nested-schema-for-default_notification_targets))
- `name` (String) Organization name. Unset = keep the current value.
- `postal_code` (String) Billing address. Unset = keep the current value.
- `require_mfa_admins` (Boolean) Require two-step verification for admins. Changing it needs a signed-in admin who has two-step verification: API tokens are refused (`nonUserSessionForbidden`). An unchanged value is never sent. Unset = keep.
- `require_mfa_customers` (Boolean) Require two-step verification for customer users (logins limited to customers). Changing it needs a signed-in admin who has two-step verification: API tokens are refused (`nonUserSessionForbidden`). An unchanged value is never sent. Unset = keep.
- `require_mfa_editors` (Boolean) Require two-step verification for team editors. Changing it needs a signed-in admin who has two-step verification: API tokens are refused (`nonUserSessionForbidden`). An unchanged value is never sent. Unset = keep.
- `require_mfa_readonly` (Boolean) Require two-step verification for team readonly members. Changing it needs a signed-in admin who has two-step verification: API tokens are refused (`nonUserSessionForbidden`). An unchanged value is never sent. Unset = keep.
- `sms_overage_safety_cap_cents_monthly` (Number) Monthly SMS overage cap in cents. Only global admins may change it (`forbidden` for organization tokens); an unchanged value is never sent. Clearing it (null) is not possible here. Unset = keep.
- `street` (String) Billing address. Unset = keep the current value.
- `vat_id` (String) VAT ID. Changing it resets the VIES verdict until it is validated again. Unset = keep the current value.

### Read-Only

- `id` (String) The organization id.

### Nested Schema for `default_notification_channels`

Required:

- `email` (Boolean)
- `integrations` (Boolean)
- `sms` (Boolean)
- `webhook` (Boolean)


### Nested Schema for `default_notification_targets`

Required:

- `email` (String)
- `integrations` (String)
- `sms` (String)
- `webhook` (String)

## Import

Import is supported using the following syntax:

The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:

```shell
# Any id; the token's own organization is used
terraform import uptimeify_organization_settings.this org
```