Infomaniak Mail icon

Infomaniak Mail

Interact with Infomaniak Mail API

Actions118

Service Mail > Signatures Templates → Update

AI-generated

Summary

Update a mail signature template for a specified hosting.

Inputs

  • authentication (required) — Authentication method: 'oauth2' or 'apiKey'
  • path_mail_hosting_id (required) — Identifier of the mail hosting
  • path_signature_template (required) — Identifier of the signature template to update
  • bodyAttributes — JSON object of additional email header attributes
  • bodyContent — Raw content of the signature template
  • bodyDefault — Boolean indicating if this template is the default signature
  • bodyFormData — JSON object of form data fields for the signature
  • bodyIsDefault — Alias for bodyDefault (boolean)
  • bodyName — Name of the signature template (may include placeholder {name})
  • bodyNameFormat — Format style for name display (options: first_last, first_only, last_first, last_only)
  • bodyNotify — Boolean to send notification after update
  • bodyPosition — Position of the signature in email (options: top, bottom)
  • bodyStatus — Current status (options: draft, enabled)
  • bodySubstitutions — JSON object of substitution values for HTML template placeholders
  • returnFullResponse — Boolean to return the complete updated template instead of just success

Output shape

a single updated signature template record

Response contains the full updated template fields; returnFullResponse controls whether the entire object is returned

Examples

Example 1: Update default signature for hosting ID 12345 using OAuth2

authentication: oauth2; path_mail_hosting_id: 12345; path_signature_template: default; bodyDefault: true; returnFullResponse: true

Example 2: Patch signature with custom content and position

authentication: apiKey; path_mail_hosting_id: 9876; path_signature_template: welcome; bodyContent: "

Thanks, Team

"; bodyPosition: top; bodyStatus: enabled

Example 3: Enable a draft signature and set substitutions

authentication: oauth2; path_mail_hosting_id: 5555; path_signature_template: promo; bodyStatus: enabled; bodySubstitutions: {"{{company}}": "Acme"}; returnFullResponse: true

Links

Discussion