ConnectCloud Developers

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): 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:

{
  "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): 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 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"}'

View as Markdown · Interactive reference · OpenAPI