Brand widget and tenant branding

​

What the restaurant sees

• Logo: upload a PNG, JPG, WEBP or GIF up to 1 MB (stored by Minimo, served over https) or paste an https link.
• Color: a hex color, with a readability check. Used for the title band and the buttons of your standard messages.
• Name and legal details: business name, legal name (data controller), address, privacy policy link.
• Contacts and social links: phone, email, website and the six social links of the footer (Facebook, Instagram, LinkedIn, X, YouTube, TikTok). Only the ones filled in show.

​

Mount it

curl -X POST https://api.minimo.it/public/v1/widgets/sessions \
  -H "Authorization: Bearer YOUR_MINIMO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tenant": "restaurant_4812",
    "tenantName": "Trattoria da Mario",
    "permissions": ["templates", "campaigns", "contacts", "history", "stats", "brand"],
    "brand": { "locked": ["legalName", "privacyUrl"] }
  }'

<div id="minimo-brand"></div>
<script src="https://api.minimo.it/public/v1/embed/widgets/widgets.js"></script>
<script>
  Minimo.mountWidget({
    url: session.urls.brand,
    container: '#minimo-brand',
    minHeight: 900,
    onEvent: function (event) {
      if (event.type === 'brand.saved') console.log('saved', event.data.fields, event.data.appliedTo);
    },
  });
</script>

• brand.locked: any of displayName, legalName, logoUrl, brandColor, address, phone, email, website, privacyUrl, socials (the six links). A locked field is read-only in the widget (“Set by your management app”) and a save that changes it answers 422 BRAND_FIELD_LOCKED.
• Events: ready with tenant; brand.saved with tenant, fields (the fields the restaurant changed) and appliedTo (personalized messages recolored).

​

Tenant profile

curl -X PUT https://api.minimo.it/public/v1/tenants/restaurant_4812 \
  -H "Authorization: Bearer YOUR_MINIMO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "displayName": "Trattoria da Mario",
    "logoUrl": "https://cdn.example.com/mario/logo.png",
    "brandColor": "#1F5E5B",
    "locale": "it",
    "legalName": "Trattoria da Mario S.r.l.",
    "address": "Via Roma 1, 20121 Milano",
    "privacyUrl": "https://trattoriadamario.example.com/privacy",
    "website": "https://trattoriadamario.example.com",
    "socials": { "instagram": "https://instagram.com/trattoriadamario" }
  }'

{
  "data": {
    "tenant": "restaurant_4812",
    "displayName": "Trattoria da Mario",
    "logoUrl": "https://cdn.example.com/mario/logo.png",
    "locale": "it",
    "legalName": "Trattoria da Mario S.r.l.",
    "address": "Via Roma 1, 20121 Milano",
    "privacyUrl": "https://trattoriadamario.example.com/privacy",
    "website": "https://trattoriadamario.example.com",
    "phone": null,
    "email": null,
    "socials": {
      "facebook": null,
      "instagram": "https://instagram.com/trattoriadamario",
      "linkedin": null,
      "x": null,
      "youtube": null,
      "tiktok": null
    },
    "brandColor": "#1F5E5B",
    "editedByTenant": [],
    "updatedAt": "2026-11-08T14:58:15.891Z"
  }
}

• Permission widgets. GET /public/v1/tenants/{tenant} reads it (404 if none).
• Only the fields you send are written, null clears one.
• URLs must be public https (422 INVALID_TENANT_PROFILE, INVALID_TENANT_URL); social links must be on their own network. brandColor is hex and not near-white (422 INVALID_BRAND_COLOR). Phone and email are checked (422 INVALID_TENANT_CONTACT).
• editedByTenant lists the fields the restaurant changed itself in the widget.
• Every widget session also refreshes the profile from tenantName, locale and these variables: RESTAURANT_NAME, LOGO_URL, BRAND_COLOR, RESTAURANT_ADDRESS, RESTAURANT_PHONE, RESTAURANT_EMAIL, LEGAL_NAME, PRIVACY_URL, WEBSITE_URL, FACEBOOK_URL, INSTAGRAM_URL, LINKEDIN_URL, X_URL, YOUTUBE_URL, TIKTOK_URL (invalid values are skipped).

​

Who wins

​

What changes in the emails

• Your standard messages sent for the restaurant (master + tenant) use its color for the title band and the buttons, its logo and its footer. {BRAND_COLOR} and {BRAND_TEXT_COLOR} (readable text on it) are available as merge values in custom HTML.
• New personalized copies and new campaigns start in the restaurant’s color. Copies it already personalized keep their colors, unless it ticks “apply to the messages I already personalized” when saving.
• The unsubscribe and preferences pages of the restaurant show its name, logo and color.
• The emails never carry a Minimo badge. Fonts follow your workspace’s branding kit.