---
title: "Update domain wide footer"
method: POST
path: "/api/v1/edit/domain/footer"
tags: ["Domains"]
---

# Update domain wide footer

`POST /api/v1/edit/domain/footer`

You can update the footer of one or more domains per request.

## Request body

- object
  - `attr` object
    - `html` string — Footer text in HTML format
    - `plain` string — Footer text in PLAIN text format
    - `mbox_exclude` object — Array of mailboxes to exclude from domain wide footer
  - `items` string[] — contains a list of domain names where you want to update the footer

## Response `200`

OK

- object
  - `log` unknown[] — contains request object
    - unknown
  - `msg` unknown[]
    - unknown
  - `type` 'success' | 'danger' | 'error'

## Other responses

- `401` — Unauthorized

## Changes

- **2023-11-23** `b050fedca62a` — 1 info
  - endpoint added
- **2020-06-07** `47523aca063a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/mailcow/apis/mailcow-api/changes/api/v1/edit/domain/footer/post.md)

---

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