---
name: "account_set_brand"
area: "account"
title: "Set the business's look"
price: "$0.001"
method: "POST"
url: "https://api.conecto.chat/v1/tools/account_set_brand"
mcp_server: "https://api.conecto.chat/mcp/account"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/account/account_set_brand"
---

# Set the business's look (`account_set_brand`)

Sets the sender name, logo, colour and footer on every email to customers and on the business's published pages.

The business's name as the sender, its logo (a PNG, JPEG, WebP or GIF from the file store), its colour and a footer line (an address, a legal line), on every email to its customers (bookings, applications, tests, signatures, invoices, newsletters, replies) and on its published pages (forms, booking, careers, newsletters, status, views). Only what you pass changes; an empty string clears it. Mail from Conecto to you keeps Conecto's look.

Price: $0.001 a call. A call that fails costs nothing.

## Use it when

The business's emails and public pages should carry its own name, logo and colour.

- For the words of one customer email, use [account_set_email_template](https://conecto.chat/tools/account/account_set_email_template.md).

## Say this to your agent

> Put our logo and the forest green on every email we send, with our Portland address in the footer.

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `sender_name` | string | no | Up to 120 characters. |  |  |
| `logo_file_id` | string | no | Exactly 36 characters. |  |  |
| `remove_logo` | boolean | no |  |  | `false` |
| `colour` | string | no | Hex, like #1a73e8; empty for none. Up to 7 characters. |  |  |
| `footer` | string | no | Up to 200 characters. |  |  |

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `account_set_brand` on the MCP server `https://api.conecto.chat/mcp/account` with these arguments:

```json
{
  "sender_name": "Halverson Cycle & Repair",
  "logo_file_id": "c4a2d8e1-6b3f-4f0a-8e57-91d2b6c3a0f4",
  "colour": "#1f4d3a",
  "footer": "Halverson Cycle & Repair, 1830 SE Ash St, Portland, OR 97214"
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/account_set_brand \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sender_name": "Halverson Cycle & Repair", "logo_file_id": "c4a2d8e1-6b3f-4f0a-8e57-91d2b6c3a0f4", "colour": "#1f4d3a", "footer": "Halverson Cycle & Repair, 1830 SE Ash St, Portland, OR 97214"}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "account_set_brand",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.001",
  "balance_usd": "$19.75",
  "result": {
    "brand": {
      "sender_name": "Halverson Cycle & Repair",
      "logo_url": "https://conecto.chat/api/attachment/952c871c-df2a-41de-bea2-612a6b743547/",
      "colour": "#1f4d3a",
      "footer": "Halverson Cycle & Repair, 1830 SE Ash St, Portland, OR 97214"
    }
  }
}
```

`result`: The brand as saved: sender_name, logo_url, colour and footer.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `not_found` | 404 | No file in the store has that logo_file_id. | Upload the logo with files_upload, or find it with files_list, and pass its file_id. |
| `invalid_input` | 400 | The colour is not a hex colour, the footer is too long, or the logo is not a PNG, JPEG, WebP or GIF the size the message gives. | Send a colour like #2b2420, a shorter footer, or a smaller logo in one of those formats. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [account_balance](https://conecto.chat/tools/account/account_balance.md): The balance, this key's daily budget, auto-reload, and how much of the month's free reads and downloads is used. Free.
- [account_refund_topup](https://conecto.chat/tools/account/account_refund_topup.md): Refunds a top-up from the last 24 hours that none of has been used: the credit, with its tax, goes back to the card, and the service fee is kept. Free.
- [account_owner_link](https://conecto.chat/tools/account/account_owner_link.md): A one-time link that signs the business owner into their Conecto page, without a password. Free.
- [account_get_limits](https://conecto.chat/tools/account/account_get_limits.md): The limits Conecto raises on request, each with its standard and current value, and the business's requests with their answers. Free.
- [account_request_limit](https://conecto.chat/tools/account/account_request_limit.md): Ask Conecto to raise a limit: which one, the number the business needs, and why. Free.
- [account_events](https://conecto.chat/tools/account/account_events.md): What happened lately, oldest first: applications, bookings, form responses, signatures, replies, emails, website goals and the agents' own events. Free up to 1,000,000 reads a month.
- [account_emit_event](https://conecto.chat/tools/account/account_emit_event.md): Sends an event the agent names, custom.<name>, to the channels subscribed to it and to account_events. $0.005 per channel it goes to.
- [account_search](https://conecto.chat/tools/account/account_search.md): One search across the business's files, table rows, help articles, CRM, emails, tickets, invoices, books, stock and tasks. Free up to 1,000,000 reads a month.
- [account_list_calls](https://conecto.chat/tools/account/account_list_calls.md): The business's recent calls, newest first, optionally only the failed or the succeeded ones, or one area's. Free.
- [account_dashboard_link](https://conecto.chat/tools/account/account_dashboard_link.md): A one-time link to a page showing one area at a glance, made when it opens from what this key may read. Free up to 1,000,000 reads a month.
- [account_get_call](https://conecto.chat/tools/account/account_get_call.md): One call by its call_id, with its status, cost and result. Free.
- [account_get_brand](https://conecto.chat/tools/account/account_get_brand.md): The name, logo, colour and footer line the business's emails and published pages carry. Free up to 1,000,000 reads a month.
- [account_list_email_templates](https://conecto.chat/tools/account/account_list_email_templates.md): Every automatic email to the business's customers, with its subject, headline, opening words and {variables}. Free up to 1,000,000 reads a month.
- [account_set_email_template](https://conecto.chat/tools/account/account_set_email_template.md): Rewrites an email's subject, headline or opening words in the business's voice; the times, amounts and links below them stay. $0.001 a call.
- [account_export_all](https://conecto.chat/tools/account/account_export_all.md): Everything the account holds, as ZIP files in its file store: every record as JSON Lines and the stored files, credentials left out. Free.
- [account_audit_log](https://conecto.chat/tools/account/account_audit_log.md): The account's admin and security actions, newest first, with a check that none was changed or removed. Free up to 1,000,000 reads a month.
- [account_save_team](https://conecto.chat/tools/account/account_save_team.md): Makes or changes a team: the areas its keys may use, a monthly budget that refuses or warns, and its ERP cost center code. $0.001 a call.
- [account_list_teams](https://conecto.chat/tools/account/account_list_teams.md): The account's teams with their areas, budgets, this month's spend, ERP codes, keys and people. Free up to 1,000,000 reads a month.
- [account_pause_team](https://conecto.chat/tools/account/account_pause_team.md): Stops every key of a team at once, until the owner starts it again. Free.
- [account_assign_team](https://conecto.chat/tools/account/account_assign_team.md): Gives a form, a number, an inbox or another thing to a team, so its charges land there. $0.001 a call.
- [account_set_owner_email](https://conecto.chat/tools/account/account_set_owner_email.md): Sends the business's owner a link to confirm they own the account, when it has no owner email yet. Free.
- [account_add_approval_rule](https://conecto.chat/tools/account/account_add_approval_rule.md): Makes a tool wait for a person's approval: every call, or calls over a limit, approved by an email, a channel or a team's managers. $0.001 a call.
- [account_list_approval_rules](https://conecto.chat/tools/account/account_list_approval_rules.md): The tools that wait for a person's approval, with their thresholds and approvers. Free up to 1,000,000 reads a month.
- [account_find_person](https://conecto.chat/tools/account/account_find_person.md): Every record the account holds about one person, by email or phone, with each kind's count and ids. Free.
- [account_export_person](https://conecto.chat/tools/account/account_export_person.md): One person's records and files in one ZIP in the file store, with a download link to give them. Free.
- [account_erase_person](https://conecto.chat/tools/account/account_erase_person.md): Erases one person across every area and says what it kept and why, like invoices the law keeps. Free.
- [account_data_locations](https://conecto.chat/tools/account/account_data_locations.md): Where each area's data is stored and processed: the company, the country or region, and what it holds. Free up to 1,000,000 reads a month.