Skip to content
Bottle
Search
Ctrl
K
Cancel
Menu
Getting started
Bottle help
Your day
Starting a business
Setting up
Flame AI
Using AI responsibly
Report a problem
Tours
Working together
Finding things
Adding users
Customers and orders
Customers
Orders
Regular deliveries and collections
Emails to customers
Privacy and retention
Deliveries and fleet
Rounds
Deliveries without rounds
Delivery partners
Bottle Brain
Fleet
Rota
The driver app
Out on the round
Tracking
Products and stock
Products
Price lists
Stock
Suppliers
Invoices and payments
Invoices
Getting paid
Cash
Cylinder hire
VAT
Bottle Shop
Your shop
Choosing a template
Copying your website
Building shop templates
Overview
Build your first template
Reference
Examples and recipes
Design and language
Troubleshooting
Colour-theme packs
Reporting
Reporting
Connections
Connecting other software
Accounting (Xero)
Connecting your shop
Orders from WhatsApp
Connecting an assistant
Your account
Signing in safely
Plans and billing
Accessibility and appearance
For developers
Overview
API keys
Permissions
Connecting over MCP
Search
Customer export
Marketing consent
Products
Shop and stock
Website import
API reference
Overview
System
Overview
Health check
Cash
Overview
List cash hand-overs
Say cash has been handed in
Agree a hand-over, or say it is wrong
Take back a hand-over
List cash owed by drivers
Read the office cash overview
Put a count-in back
Get the signed-in driver's cash
List cash takings
Read the office cash ledger
Settle the cash a driver is carrying
Account
Overview
Register a phone for push notifications
Stop push notifications to a phone
List invitations waiting for you
Accept an invitation waiting for you
Turn down an invitation waiting for you
Export your account data
Close your account
Accept the terms and the privacy notice
Get the signed-in user
Create a business
Get the business profile
Update the business profile
Users
Overview
Allow a driver to take stock
Let an owner or admin drive rounds
List members
Remove a member
Change a member's role
Invitations
Overview
Get an invitation by token
Accept an invitation
List open invitations
Create an invitation
Resend an invitation
Cancel an invitation
Customers
Overview
Read how customer account numbers work
Change how customer account numbers work
Number every customer without an account number
Put customers on a price list
Export customers as CSV
A customer's marketing consent
Record or remove marketing consent
List customers
Create a customer
List the ids of matching customers
Find customers from a name typed roughly
Get a customer
Archive a customer
Update a customer
Change several customers
List customer contacts
Add a customer contact
Remove a customer contact
Change a customer contact
List possible duplicate customers
List possible duplicates of a customer
Dismiss a duplicate suggestion
Get delivery times
Set delivery times
List delivery addresses
Create a delivery address
Update a delivery address
Merge two customers
List driver notes from a customer’s completed visits
Add the same opening cylinders to several customers
Confirm several customers' cylinder balances
List the cylinders a customer is holding
Record cylinders held before Bottle
Record an opening cylinder balance
Confirm a customer cylinder balance
List cylinder problems customers reported
List the cylinder problems a customer reported
Write off a reported cylinder
Dismiss a reported cylinder problem
Invoice the customer for a reported cylinder
List trade account requests
Get a trade account request
Approve a trade account request
Decline a trade account request
Send a shop invitation again
Find existing shop sign-ins to give customer access
Give an existing shop sign-in access to a customer
Change a shop sign-in’s role on a customer
Invite somebody to buy for a customer on the shop
Take a shop invitation back
Email a customer their prices
Stop a shop sign-in buying for a customer
API keys
Overview
List API keys
Create an API key
API key requests from the last 30 days
Revoke an API key
Connections
Overview
List connected apps
Disconnect an app
Change an app's permissions
Billing
Overview
Get the subscription
List Bottle invoices
Sync the subscription from Stripe
Start a checkout session
Change the plan
Open the billing portal
Help chat
Read Flame AI settings
Update Flame AI settings
Check help chat availability
List your private help conversations
Read your help conversation
Delete your help conversation
Ask a question about using Bottle
Business
Read Assets and Equipment servicing settings
Switch Assets or Equipment servicing on or off
Assets
List cylinder details
Add a cylinder detail
Add the usual details for medical oxygen
Stop recording a cylinder detail
Change a cylinder detail
List tracked cylinders
Record a cylinder you already have
Look up serial numbers before receiving them
Receive full cylinders into a yard, by serial number
Check a count of one product at a yard, by serial number
Save a count of one product at a yard, with the corrections chosen
Get a cylinder and where it has been
Change a cylinder's details
Mark a cylinder faulty, lost, retired or back in use
Get work report settings
Change work report settings
List work report job types
Add a work report job type
Remove a work report job type
Change a work report job type
List work report checks
Add a work report check
Remove a work report check
Change a work report check
List an order's work reports
Imports
List recent imports
Import rows
Check rows before importing them
Undo an import
Support
Whether Bottle Support is switched on
Sign the person in to Bottle Support
List my support tickets
List my support tickets that are waiting on me
Get one of my support tickets
Get what Bottle support may do in this business
Set what Bottle support may do in this business
List requests from Bottle support
Approve or decline a request from Bottle support
Rosie
Start a conversation with Rosie
Read a conversation with Rosie
Ask Rosie something
Email the conversation with Rosie
End a conversation with Rosie
Help
Search the help guides
Email log
List emails sent
One email, as it was sent
Products
List price lists
Add a price list
Get a price list and its prices
Archive a price list
Rename a price list
Set a price list’s prices
Choose a price list’s deposit or rent on each gas type
Fill a price list from the Trade price
Download a price list's price sheet
Email a price list's price sheet
List imported products waiting for a look
Suggest gas types for imported products
Accept or dismiss a suggestion
Approve selected edits or confident suggestions
Put the pictures in order
List a product's pictures
Add a picture to a product
Remove a picture
Change a picture
List shop categories
Create a shop category
Delete a shop category
Update a shop category
List product details
Create a product detail
Put product details in order
Update a product detail
Set a product detail on many products
Delete a gas type
Update a gas type
List gas types
Create a gas type
List the products ordered most
List products
Create a product
Get a product
Update a product
Change several products
Upsert a product from a shop
Get a product’s stock
Count or move a product’s stock
Stop counting a product
List a customer's agreed rates
Download a customer's price sheet
Set an agreed rate
Remove an agreed rate
Get every price a product has
Set a product’s quantity breaks and price list prices
Get the deposit and rent on a cylinder
Put a deposit or rent on a cylinder
Get the deposit and rent on a gas type
Take a deposit or rent off a cylinder
List price rules
Add a price rule
Get a price rule
Replace a price rule
Delete a price rule
Storefront
Get a shop picture
Orders
List drivers who can hold an order cash payment
Record money received against an order
Reverse an incorrect office receipt, keeping its history
Send a payment link
Mark an order paid or unpaid
Remove undelivered items
Settle a refund
Add a cylinder deposit refund
List orders
Create an order
Order counts for the day
List the ids of matching orders
Preview cylinder charges on a new order
Get an order
Delete an unconfirmed draft order
Update an order
Correct a delivered or part-delivered order and its unpaid invoice
Correct how many of each item were delivered, and the empties collected
Change several orders
Download orders as CSV
Confirm a reviewed draft order
Get the business surcharge rule
Save the business surcharge rule
List the day's deliveries and collections
Print the day as a run sheet
List delivery options
Create a delivery option
Update a delivery option
List standing orders
Create a standing order
Get a standing order
End a standing order
Update or pause a standing order
Entry drafts
List shared office drafts
Start a shared draft
Find an existing customer for this conversation
Catalogue and addresses for human order entry
Calculate live order prices without saving an order or conversation
Edit and reprice a proposed order without creating it
Read a shared draft
Compose through read-only MCP tools
Review exact customer and order totals without creating live records
Accept the reviewed version once; then run normal order notifications
Save the reviewed order in Draft state without customer communications
Rounds
Say a delivery partner has been sent its list
Email a delivery partner the day's list
Download a delivery partner's list for the day
List delivery partners
Add a delivery partner
Remove a delivery partner
Change a delivery partner
Restore an archived delivery partner
List a day's orders with delivery partners
Use a delivery partner
Take an order off its delivery partner
The question to ask about a move
Say what a move meant
List what Bottle has learned
Tell Bottle something
Delivery areas to offer drivers
Add a suggested delivery area
Stop offering a suggested delivery area
Read an answer in the owner interview
Work out what the owner means
Save what the owner confirmed
Delete something you told Bottle
Correct what you told Bottle
Say something Bottle learned is wrong
Say something Bottle learned is right
Take back saying something was wrong
How far Bottle can go
Set how far Bottle can go
Who stands in while the owner is away
Set who stands in while the owner is away
When Bottle plans the next day
Set when Bottle plans the next day
List delivery patches
Create a delivery patch
Delivery patch sizes and overlaps
Delete a delivery patch
Update a delivery patch
List bases
Create a base
Update a base
Look up the nearest postcode
List vehicles
Create a vehicle
Update a vehicle
List driver profiles
Update a driver profile
Who is off on a day
Mark a driver off for a day, or back on
List rounds
Create a round
What is still wrong with a day's plan
Get a round
Delete a planned round
Update a round
Issue a round to its driver
Retract a round from its driver
Update a round's status
Get live timing for a round
Say where the round's van is
Move a stop to another day
Create a payment link at the door
Reorder the remaining stops
Record a stop outcome
Plan a whole day
Get ways to bring a round within its limits
Get a round's load
Confirm what was loaded
Put more stock on the van mid-round
Check new-drop prices before adding it
Add an unplanned stop
Find a customer from the van
A door asks for more
Take cash at a door
Price what a door is about to take
Reverse a planned round’s delivery order
Say a yard collection is already on the vehicle
Collect at the yard after all
Collect a yard’s stock somewhere else today
Collect a yard’s stock at its usual yard again
Work out a planned round’s delivery order
Move an order between rounds
Create a ten-minute phone capture link
Check whether the phone sent a document
Remove a captured document after it has been saved
Get a vehicle's operational record
Add work to a vehicle service history
Remove an incorrect service-history entry
Upload a private vehicle document
Save a reviewed service record and its source document
Read the mileage and date from vehicle paperwork
Open a private vehicle document
Remove a vehicle document
The caller's day, for the driver apps
Get planning settings
Update planning settings
Get today's overview
Who is planning a day
Check delivery area coverage
Find the postcode districts of a place
Find delivery area terms that match nothing
Look up a picked address
Suggest whole addresses
Suggest postcodes
List the addresses at a postcode
Payments
Choose an existing payment-provider account
Finish payment-provider account selection
What the business's payment provider reports
List configured payment providers
Get the payment account
Connect a payment account
Privacy
Get retention settings
Update retention settings
List customers due for erasure
Export a customer's data
Erase a customer
List erasures
Vehicle document capture
Open a short-lived phone capture
Add one camera page to a short-lived capture
Finish a phone capture
Rota
Days the business does not deliver
Change the bank holiday settings
Close for a day or more
Open again
Get the time off settings
Change the time off settings
List shift patterns
Design a shift pattern
Delete a shift pattern
Change a shift pattern
Set a driver's pattern and time off terms
List time off
Ask for or book time off
Approve or decline a request
Cancel time off
Approve or decline cancelling time off
List cover
Put somebody on cover
Take somebody off cover
The rota between two dates
Reporting
Get the reporting overview
Get this person’s reporting dashboard layout
Save this person’s reporting dashboard layout
Export the reporting overview
Notifications
List my notifications
Mark a notification read
Mark every notification read
What I want to hear about
Change what I want to hear about
Browser notification availability for my session
Enable browser notifications for my current session and business
Disable browser notifications for this browser and business
Live
Hear what changes
Who is here
Say where you are
Say you have gone
Say where you are pointing
Search
Search the business
Accounting
Where the business stands with Xero
Disconnect Xero
Change the accounting settings
Review the Xero organisations awaiting confirmation
Confirm which Xero organisation to connect before syncing
Cancel an unconfirmed Xero connection
Start connecting Xero
Xero sending the browser back
The organisation's accounts
Run the sync now
Setup
Mark awards as celebrated
How far setup has got
Complete the first-run business identity check
Skip, unskip or answer a step
Hide or show the setup hub
Tracking
Get delivery tracking
Set where to leave a delivery
Shops
List connected shops
Connect a shop
Start connecting a WooCommerce shop from its own admin
WooCommerce handing over the key it made
Disconnect a shop
Update a shop
Preview a catalogue import without changing products
Pull a shop's catalogue
Search the paginated shop order import history
Read an import result and its recent outcome history
Set up automatic shop order imports
Queue a check for missed shop orders
List shop orders that need review
List paid shop orders that have not come into Bottle
Retry one reviewed shop order
Shop
List delivery areas
Add a delivery area
Remove a delivery area
Change a delivery area
List the shop’s pages
Write a page
Get a page
Move a page to the bin
Change a page
Save a page’s draft
Publish a page
Discard a page’s draft
List what is in the bin
Restore something from the bin
Put a menu in the bin
Delete something in the bin for good
List the blog’s posts
Write a blog post
Get a blog post
Move a blog post to the bin
Change a blog post
List saved shop themes
Upload and apply a Bottle theme pack
Check a custom HTML, CSS and JavaScript shop template
Upload a custom HTML, CSS and JavaScript shop template
Apply a saved theme to the draft
Apply a design from the Bottle theme library
Remove an unused saved theme
Get the shop
Switch the shop on
The assistant’s last change
Put back the assistant’s last change
Publish the shop
Take the shop down for now
Throw away unpublished changes
Switch the shop off
Save the draft
Upload a shop picture
Which filters show on the shop
Preview the draft
Add a domain
Check a domain
Make a domain the main one
Remove a domain
How copying the website is going
Copy the WooCommerce website into the shop
Undo copying the website
Get the installed sandboxed custom template for a public shop page
Get a shop, by its address
Get one of a shop’s pages
List a shop’s blog posts
Get one of a shop’s blog posts
Check a postcode
Price a basket
Pay for a basket
Get a checkout, for its thank-you page
Customer email
Get customer email settings
Save customer email settings
Check email domain DNS
Stop sending from the custom email domain
List connected shops and who each one's emails come from
Set a connected shop's own sender address, or go back to the business's
Check a connected shop's email domain DNS
Preview a branded customer email
Send a test to the signed-in person only
Shop accounts
Make an account
Confirm the email
Sign in
Give the authenticator code
Turn the authenticator off
Sign out
Forgotten password
Set a new password
Get the account
Change the account
Marketing preferences
Change a marketing preference
Change the password
Start setting up an authenticator
Turn the authenticator on
Set an ordering PIN
Remove the ordering PIN
List the account’s orders
Download an invoice
List the cylinders held
List the cylinders held, and what each costs or gives back
Report a problem with a cylinder
Withdraw a cylinder report
Where the trade request stands
Ask for a trade account
List invitations waiting
Invite a colleague
Take an invitation back
Send an invitation again
Accept an invitation
List colleagues
Remove a colleague
Change a colleague’s role
Get prices for the signed-in buyer
Stock
The rent cylinders out are running at
List which customers hold which cylinders
Get stock levels
List stock movements
Move stock
Move stock, several lines at once
List transfers between yards
Move stock between yards
Get a transfer
Move a courier transfer on
Cancel a transfer
Put a transfer on one of your rounds
Take a transfer off its round
Move a transfer to another day
The stock report
List low-stock levels
Set a low-stock level
Get yards and cylinder counts for a stock take
List stock takes and their recorded changes
Save a reviewed yard stock take
Set what a supplier supplies
Set what a supplier charges
List suppliers
Add a supplier
Get a supplier
Change a supplier's details
Archive a supplier
Bring back an archived supplier
Add a contact at a supplier
Remove a contact at a supplier
Change a contact at a supplier
Make a contact the main one
List orders from suppliers
Order stock from a supplier
Get an order from a supplier
Mark an order as arrived
Mark an order as confirmed by the supplier
Cancel an order from a supplier
The photo of a delivery note
Invoices
List the ids of matching invoices
Check payment reminders before sending
Mark several invoices paid
Cancel several invoices
Download several invoices as PDFs
Send payment reminders
Who owes most
Get a customer's balance link
What was invoiced, month by month
Preview scheduled invoices building up
Raise pending invoices now
List invoices
See an invoice correction history
Get an invoice
Download an invoice as a PDF
Mark an invoice paid, or not
Cancel an invoice
Cancel and reissue an invoice
Raise the invoices that are due
Get invoice settings
Update invoice settings
Tax
Get VAT settings
Update VAT settings
WhatsApp
Where the business stands with WhatsApp
Disconnect WhatsApp
Change how Bottle handles WhatsApp messages
Finish connecting a WhatsApp Business number
WhatsApp conversations from the last week
Say which customer a WhatsApp conversation is from
Take a WhatsApp conversation off the list
Delete a WhatsApp chat
Hand a WhatsApp conversation back to Bottle
Reply to a customer on WhatsApp
Overview
Billing
Section titled “Billing”
What a business pays, and the doors to Stripe
Operations
Section titled “Operations”
GET
/billing
GET
/billing/invoices
POST
/billing/reconcile
POST
/billing/checkout
POST
/billing/plan
POST
/billing/portal