ConnectCloud Developers

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): Markdown
  • enabled (boolean): Whether the signature is added to new mails
  • updatedAt (string (date-time), read-only): When the signature was last saved
  • userRef (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"

View as Markdown · Interactive reference · OpenAPI