Save the caller's mail signature (desk:write)
PUT /api/desk/v1/me/mail-signature
Module: Desk · operationId: setMyMailSignature · Tag: Mail · Auth: access token (Authorization: Bearer <accessToken>)
A person's own setting; service accounts get 403 person_required.
Request body
application/json (required)
body(string): Markdownenabled(boolean): Whether the signature is added to new mailsupdatedAt(string (date-time), read-only): When the signature was last saveduserRef(string, read-only): Login (e-mail) of the agent
Example:
{
"body": "Viele Grüße\nSophie Huber\nService Desk · Muster IT GmbH\nTelefon +49 851 123456-10",
"enabled": true,
"updatedAt": "2026-09-01T08:00:00Z",
"userRef": "sophie.huber@muster-it.example"
}
Responses
- 200 Saved (
application/json) - 403 Error (
application/json)
Fields of the 200 answer:
body(string): Markdownenabled(boolean): Whether the signature is added to new mailsupdatedAt(string (date-time), read-only): When the signature was last saveduserRef(string, read-only): Login (e-mail) of the agent
Example 200 answer:
{
"body": "Viele Grüße\nSophie Huber\nService Desk · Muster IT GmbH\nTelefon +49 851 123456-10",
"enabled": true,
"updatedAt": "2026-09-01T08:00:00Z",
"userRef": "sophie.huber@muster-it.example"
}
Example request
curl -X PUT 'https://api.mbcom.cloud/api/desk/v1/me/mail-signature' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"body":"Viele Grüße\nSophie Huber\nService Desk · Muster IT GmbH\nTelefon +49 851 123456-10","enabled":true,"updatedAt":"2026-09-01T08:00:00Z","userRef":"sophie.huber@muster-it.example"}'