Quickstart

Set up your account, connect the app you want to shop from, and make your first purchase.

Sangria lets an AI agent shop for you and pay from a credit balance you fund up front. Set it up once, then use it from whichever app you already work in.

1. Set up your account

Three things. Setup walks you through all of them and takes about a minute.

An account — sign up at getsangria.com.
A delivery address — where your orders go.
Credits — Sangria spends from a balance you fund ahead of time, so there's nothing to pay at checkout.

Set your country and postal code before your first search

Your country and postal code are what Sangria needs to search: the country picks your marketplace and currency, and the postal code is what lets Sangria show products, prices and delivery for your area. Searching fails until both are saved — it's the most common first-run stumble. The rest of the address, plus a phone number, is what it needs to buy.

What you can buy. Physical products from Amazon, on the marketplace for your country: Sangria supports the United States and Singapore. Some categories aren't supported, and those requests are refused up front, before anything is charged.

What you'll pay. Every match comes back with the item price, the estimated tax, and the estimated total. Your credits are charged the total. Searching is free — no money moves until you approve a specific product.

2. Pick how you'll use Sangria

They all reach the same account, balance, and delivery address, so you can set up more than one.

Message Sangria and it shops for you.

iMessage

Text Sangria from your iPhone, iPad or Mac.

Claude

Add Sangria as a connector in the Claude app, then shop in the chat.

ChatGPT

Add Sangria as a connector in ChatGPT, then shop in the chat.

CLI

Claude Code and the sangria command in your terminal.

3. Make your first purchase

Ask for what you want in plain language:

Find me decaf espresso pods that work with a Nespresso machine, under $30.

Sangria searches and comes back with up to 5 matches, each carrying the item price, an estimated tax, and an estimated total. Pick one and say yes — whatever you're using repeats the total before buying, and that confirmation is your last chance to decline.

Once you approve, the order is placed and your credits are charged the total. Ask about your orders any time to see what you've bought.

A quote stays valid for about 45 minutes. If you take longer than that to decide, whatever you're using searches again for a fresh price before buying.

If something goes wrong

The connection stopped working.

In Claude or ChatGPT — the connection expired; reconnect from Settings → Connectors and approve access again.
On Telegram or iMessage — send the chat another message and tap Reconnect Sangria in its reply.
On the CLI — re-run sangria auth set with a key from your dashboard.

It says your delivery setup isn't finished. Add or complete your address in Settings, then ask again. A country and postal code are needed to search; the full address and a phone number are needed to buy.

It says you're out of credits. Add credits from your dashboard — the Top Up button sits next to your balance, and your saved card lives in Settings. In a messaging app you can also just ask the chat to top up.

It says a spending limit was reached. The purchase was refused and nothing was charged. Adding credits won't help — this is a cap on the agent, not your balance. Raise or clear the limit on that agent in your dashboard and buy again with the same quote, or wait for older purchases to age out of the window — in that case the quote will have expired, so search again first. The message says which of the two applies: if the item costs more than the whole cap, waiting can never help.

It won't buy something. Sangria doesn't sell every category, and those requests are refused before anything is charged. Ask for a different product.

A connector refuses because of personal details. Product searches through a connector can't carry personal information — addresses, phone numbers, card details, ID or health data. Describe just the product; Sangria already has your delivery details.

A chat connect link expired, or the chat is already linked elsewhere. Message the chat again for a fresh link — /start on Telegram, or any message on iMessage. A chat connects to one Sangria account at a time; if it's linked to another, disconnect it from that account's dashboard first, then connect again.