A reseller's branding of the e-mails its customers receive: a logo and four colours, which the e-mail layout reads as %brandLogo%, %brandTextColor% etc. (see e-mail_layout_and_branding). Stored in ResellerBrandings. Without a branding the e-mails have the colours they always had and no logo.
The logo is stored on the image server without access check, as e-mail clients fetch it; the e-mails show it at the logo width, from a copy at twice that width.
All four requests take the query parameter reseller (required). Access: RESELLER for its own tree, RESELLER_ADMIN, ADMIN - read access for GET, write access for the others.
| URL | Method | Description |
|---|---|---|
/messagetemplates/branding?reseller= | GET | The branding. |
/messagetemplates/branding?reseller= | PUT | Save the logo width and the colours. Body: logoWidth (20 - 600 pixels), colors (text, background, link, footer, each #rrggbb). The logo is uploaded on its own. |
/messagetemplates/branding/logo?reseller= | POST | Upload the logo (multipart, one file, PNG, JPEG, GIF or SVG). It is saved at once; the previous logo is deleted from the image server. |
/messagetemplates/branding/logo?reseller= | DELETE | Remove the logo. |
All four return the branding:
| Field | Type | Description |
|---|---|---|
| logo | Id | Id of the logo on the image server, null without one. |
| logoUrl | String | Public URL of the logo as the e-mails use it, null without one. |
| logoWidth | Number | Width the logo is shown in, pixels. 200 by default. |
| colors | Object | text, background, link, footer - #rrggbb, the defaults filled in. |
| defaults | Object | logoWidth and colors of the master look, for a “default colours” button. |
| updatedAt | Date | When the branding was last saved, null when never. |
| updatedByName | String | Who saved it. |
{ logo: '6720b1c55d2a4c0012345678', logoUrl: 'https://image.telecomx.dk/6720b1c55d2a4c0012345678.png?width=400', logoWidth: 200, colors: { text: '#505060', background: '#f8f8f8', link: '#c00000', footer: '#909090' }, defaults: { logoWidth: 200, colors: { text: '#505060', background: '#f8f8f8', link: '#5050a0', footer: '#909090' } }, updatedAt: '2026-10-30T15:02:44.000Z', updatedByName: 'Jens Hansen' }
| Error code | Message | Description |
|---|---|---|
| 403 | access_denied | Insufficient access level, or a reseller outside the user's tree |
| 404 | reseller | Reseller not found |
| 422 | reseller | Missing or not a valid id |
| 422 | logoWidth | The logo width must be between 20 and 600 pixels |
| 422 | colors | A colour is not valid |
| 422 | logo | No file uploaded, or not an image |
| 500 | internal_error | <Unspecified> |