The caller's mail signature (Markdown) (desk:read)
GET /api/desk/v1/me/mail-signature
Module: Desk · operationId: getMyMailSignature · Tag: Mail · Auth: access token (Authorization: Bearer <accessToken>)
A person's own setting; service accounts get 403 person_required.
Responses
- 200 Signature (
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 GET 'https://api.mbcom.cloud/api/desk/v1/me/mail-signature' \
-H "Authorization: Bearer $ACCESS_TOKEN"