---
title: "Update an organization"
method: POST
path: "/organizations/{id}"
tags: ["Organization"]
---

# Update an organization

`POST /organizations/{id}`

## Request

- Base URL: `https://api.palisade.email`
- URL: `https://api.palisade.email/organizations/{id}`
- Auth: one of:
  - HTTP bearer
  - HTTP basic

## Path parameters

- `id` string, uuid, required

## Headers

- `Palisade-Version` '2025-04-30' | 'unstable', required

## Request body

- object
  - `is_active` boolean: Whether or not the organization should be active.
  - `name` string
  - `logo_url` string, uri
  - `email` string, email: Organization contact email address.
  - `phone_number` string: Organization contact phone number.
  - `website` string, uri: Organization website URL.
  - `settings` object: Organization settings including email notification preferences.
    - `email_notifications` object: Email notification preferences for the organization. Controls which types of emails are sent.
      - `domain_drifted` boolean: Send notifications when domain DNS records drift from expected configuration.
      - `domain_failed` boolean: Send notifications when a domain fails DMARC validation checks.
      - `domain_setup` boolean: Send notifications when a domain DMARC configuration is successfully set up.
      - `tasks_digests` boolean: Send daily digest of new and pending tasks.
      - `setup_reminders` boolean: Send reminders to finish adding and verifying a first domain.
      - `first_report` boolean: Send an email when a newly set-up domain's first DMARC data arrives, and its first report a week later.
      - `invitation_reminders` boolean: Remind invitees about an unaccepted invitation, and tell the inviter which invitations are about to expire.
      - `billing_notices` boolean: Send plan-usage notices, such as passing the Free plan monthly email allowance.
      - `hosted_spf_live` boolean: Send a one-time email when a domain's Hosted SPF setup finishes and starts serving.
      - `delegation_missing` boolean: Send a notification when a domain never delegated to a record Palisade hosts for it, so the hosted record is not serving. Controlled separately from domain_drifted.
  - `require_mfa` boolean: Require every member to complete multi-factor authentication at each sign-in. Only an administrator of this organization can change it, from a signed-in session rather than an API key, and changing it in either direction is refused with `mfa_confirmation_required` until that administrator's own sign-in has completed multi-factor authentication.

## Response `200`

Success

- Organization
  - `id` string, required
  - `name` string, required
  - `logo_url` string, nullable, required
  - `email` string, nullable, required
  - `phone_number` string, nullable, required
  - `website` string, nullable, required
  - `is_active` boolean, required
  - `require_mfa` boolean, required: Whether every member must complete multi-factor authentication to sign in to this organization. A member who has not set up an authenticator is asked to at their next sign-in.
  - `settings` object, nullable
    - `email_notifications` object: Email notification preferences for the organization. Controls which types of emails are sent.
      - `domain_drifted` boolean: Send notifications when domain DNS records drift from expected configuration.
      - `domain_failed` boolean: Send notifications when a domain fails DMARC validation checks.
      - `domain_setup` boolean: Send notifications when a domain DMARC configuration is successfully set up.
      - `tasks_digests` boolean: Send daily digest of new and pending tasks.
      - `setup_reminders` boolean: Send reminders to finish adding and verifying a first domain.
      - `first_report` boolean: Send an email when a newly set-up domain's first DMARC data arrives, and its first report a week later.
      - `invitation_reminders` boolean: Remind invitees about an unaccepted invitation, and tell the inviter which invitations are about to expire.
      - `billing_notices` boolean: Send plan-usage notices, such as passing the Free plan monthly email allowance.
      - `hosted_spf_live` boolean: Send a one-time email when a domain's Hosted SPF setup finishes and starts serving.
      - `delegation_missing` boolean: Send a notification when a domain never delegated to a record Palisade hosts for it, so the hosted record is not serving. Controlled separately from domain_drifted.
    - `onboarding_dismissed_at` string, date-time, nullable: When someone dismissed or finished the onboarding wizard for this organization. Absent or null means nobody has, and the wizard is still offered to an organization with no domains.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `support_provider` 'palisade' | 'sherweb', required
  - `has_domains` boolean

---

[API](https://skmtc.dev/palisade/apis/palisade-api.md) · [All operations](https://skmtc.dev/palisade/apis/palisade-api/llms.txt) · [OpenAPI document](https://skmtc.dev/palisade/apis/palisade-api/revisions/37b4ae5a7766?raw)