---
title: "Create/Update Bimi"
method: POST
path: "/1/mail_hostings/{mail_hosting_id}/bimi"
tags: ["Service Mail > Bimi"]
---

# Create/Update Bimi

`POST /1/mail_hostings/{mail_hosting_id}/bimi`

Create or update (if you already have one) the bimi associated to the mail service

## Path parameters

- `mail_hosting_id` string, required

## Request body

- object
  - `link_logo` string, binary
  - `link_vmc` string, binary
  - `logo` string, binary
  - `vmc` string, binary

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 93e74a89CreatedorUpdatedBimi
    - `status` string, required — Status of the resource `Created or Updated Bimi`
    - `state` 'CERTIFIED' | 'ERROR' | 'EXPIRED' | 'NOT_CERTIFIED', required — Indicates the current state of the BIMI (Brand Indicators for Message Identification) associated with a mail service.<note><strong>certified</strong>: The BIMI is certified and valid. The brand logo will be displayed in supported email clients.</note><note><strong>error</strong>: An error occurred with the BIMI setup. The brand logo will not be displayed, and further investigation is needed.</note><note><strong>expired</strong>: The BIMI certification has expired. The brand logo will not be displayed until the certification is renewed.</note><note><strong>not_certified</strong>: The BIMI is not certified. The brand logo may not appear in many email clients.</note>
    - `svg_uri` string, required — The URL of the SVG image associated with the BIMI record
    - `vmc_uri` string, required — The URL of the VMC (Verified Mark Certificate) associated with the BIMI record
    - `current` string, required — The current DNS record for the BIMI, including the version, SVG link, and VMC link

## Other responses

- `404` — Not Found

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/158a854b0c7d/schema)