Write an offer
An offer lives on a lead or an organization. An admin turns Offers on under Admin › People › Workspace. You edit offers on the web and the Mac. On iPhone and Android you read an offer, share its link, duplicate it and record the buyer's answer. An agent connected over MCP has the web's tools.
Start one
- Open the lead or the organization in Work.
- In the Offers group, choose +.
A new offer is a draft, and no buyer can read it. If the organization has a partner discount, the draft starts with it. To set one, use Partner discount in the organization's Offers group on the web or the Mac.
Add lines
A line from the catalog takes its name and description from the service, and its price unless you change it. A custom line has your own title and price. An optional line does not count in the total: the buyer may take it when they accept.
The server works out every total. Prices are in EUR, and EUR is binding. In another currency the figures are indicative.
Send it
Choose Send. The offer needs a line that is not optional, a person it is for, and a valid-until date in the future. Send freezes the rate and the totals and gives you the link. Starlings sends no email: you share the link yourself.
Until you send it, Delete removes the draft and its lines, on the web and the Mac. It asks first. A sent offer cannot be deleted, because the buyer holds its link: record a reject or duplicate it.
What the buyer sees
The link opens the offer on your workspace's site, at /offer/<id>. The buyer
enters their email address first. Anyone with the link can read the offer. Only an
address the offer names, or another address at the same company, can sign it,
save billing details and fill in what the services ask for. The offer's recipient,
the lead's contact and the organization's contacts count. An offer that names
nobody lets any address sign.
The page shows the parties, the lines and totals, your notes, the terms of each service, the payment details, the billing form, the service inputs, the offer links and the signature. The buyer may take optional lines when they sign. A signed offer sends the signer a confirmation email and says so on the lead.
When the buyer opens the offer, Starlings logs the view and says so on the lead, once per address. Your own team's views are not logged. An expired offer offers Ask for more time: it moves the deadline a month on, says so on the lead and proposes a Decide extension request task.
What the buyer writes shows under From the buyer on the offer, on the web, the Mac, iPhone and Android: the billing email, PO number and VAT ID, and each service input with the service it belongs to. The buyer owns these values, so they are read-only for your team.
Change it after sending
Edit the offer as usual. The header says Unsent changes, and the buyer still reads what you sent. Choose Send update to send the changes as a new version on the same link. Earlier versions stay under Versions.
Record the answer
Choose Record accept or Record reject when the buyer tells you. An accepted offer is locked on the version the buyer read. Any unsent changes are dropped. To change an accepted offer, duplicate it.
An accept does the same as the buyer's own accept:
- Optional lines the buyer took become regular lines.
- If the offer has recurring lines, it makes a license for a year, for the recurring total after the discount. The year starts on the agreement's start date, or else the day the offer was created. An offer that has a license keeps it.
- If the offer is on a lead with no project yet, it makes a project with the lead's title and organization, and closes the lead as won. A lead that has a project keeps it, and its status does not change.
- It proposes a Kick off delivery task on the new project, or else the lead.
Open project takes you to the project. Licenses show in the organization's Licenses group when an admin has that module on. A workspace at its plan's project limit refuses the accept, and nothing changes.
Reuse an offer
Duplicate copies any offer to a new draft: lines, discount, notes, terms and entity. The title starts empty. On the web and the Mac, choose a lead or an organization to put the copy there. On a phone the copy stays on the same subject. There are no templates. Duplicate an offer instead.
The catalog
Work › Catalog lists every service. You can change a price, words and whether a service is on the rate card. You cannot rename a service: create a new one and take the old one off the rate card. A sent offer keeps its own words and price.
Each service also carries the terms the buyer agrees to and its data and
privacy notes, in markdown, and one optional field the buyer fills in (such as
technical considerations). Services with the same terms show them once. The terms
may name {{client}}, {{provider}}, {{notice_email}}, {{start_date}},
{{end_date}} and {{total}}, and the buyer's page fills them in. An offer's
terms override replaces the services' terms. Send freezes the terms with the
version, so the buyer signs what you sent. A later catalog edit reaches an offer
only when you choose Send update. Edit the terms on the web, the Mac or over
MCP.
Payment terms, currencies, corporate entities, delivery conditions, offer links and policies are under Admin › Records, on the web. Commercial settings on the Mac's Catalog page opens it.
Where it works
| Capability | macOS Host | macOS Join | Web | iOS / iPadOS | Agent access |
|---|---|---|---|---|---|
| Projects and leads, with their tasks and issues | Works | Works | Works | Works | search (MCP), open (MCP), task (MCP), record_decision (MCP), set_goal (MCP), starlings://subject/{kind}/{id}, starlings://subjects/{kind}, starlings://board/{days}, starlings://board/project/{id}/{days}, /api/crm/board, /api/crm/tasks, /api/crm/mine, /api/crm/recently-closed, /api/crm/unowned, /api/crm/goals, /api/crm/decisions, /api/crm/subjects, /api/crm/organizations |
Verified · docs/help/howto/write-an-offer.md