Set the business's look
Sets the sender name, logo, colour and footer on every email to customers and on the business's published pages.
$0.001 a call
From your agent’s balance. A call that fails costs nothing.
An example
Put our logo and the forest green on every email we send, with our Portland address in the footer.
Your agent callsaccount_set_brand$0.001 a call
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
{
"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"
}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.
What it does
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.
What comes back
The brand as saved: sender_name, logo_url, colour and footer. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
sender_name | string | Up to 120 characters. |
logo_file_id | string | Exactly 36 characters. |
remove_logo | boolean | Default: false. |
colour | string | Hex, like #1a73e8; empty for none. Up to 7 characters. |
footer | string | Up to 200 characters. |
The call
Over MCP, call account_set_brand on https://api.conecto.chat/mcp/account. Over REST:
curl -X POST 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"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | 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_input400 | 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. |
More Account tools
All 28 tools- Check balance
account_balanceThe balance, this key's daily budget, auto-reload, and how much of the month's free reads and downloads is used.Free - Refund a top-up
account_refund_topupRefunds 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 - Get a sign-in link for the owner
account_owner_linkA one-time link that signs the business owner into their Conecto page, without a password.Free - Read the limits
account_get_limitsThe limits Conecto raises on request, each with its standard and current value, and the business's requests with their answers.Free - Ask for a higher limit
account_request_limitAsk Conecto to raise a limit: which one, the number the business needs, and why.Free - Read recent events
account_eventsWhat happened lately, oldest first: applications, bookings, form responses, signatures, replies, emails, website goals and the agents' own events.Free* - Send an event of your own
account_emit_eventSends an event the agent names, custom.<name>, to the channels subscribed to it and to account_events.$0.005 per channel it goes to - Search everything
account_searchOne search across the business's files, table rows, help articles, CRM, emails, tickets, invoices, books, stock and tasks.Free*
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md