Create an order
create_orderReserve a slot and get a payment link. This is the only way to buy — there is no checkout on the website. The slot is held for 30 minutes. Confirm the exact time and the price with the buyer before calling this, and use their real email address: the calendar invitation and receipt go there. You must call list_products first, put the session options to the buyer in your own reply, and wait for them to choose. This tool needs the catalogue_token from that call and buyer_confirmed_session: true, which you may only set once the buyer has actually answered. Choosing a session on their behalf from what they said earlier is not the same as asking, and is not acceptable here. Before calling, ask the buyer what they want to discuss and what they are hoping to get out of the call, and pass their answers as topic and desired_outcome. Fifteen minutes is short; the seller uses these to prepare, and a booking that arrives blank wastes some of the time the buyer paid for.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Buyer's name, as it should appear on the invite | |
| Yes | Buyer's email — receives the calendar invitation | ||
| topic | No | What the buyer wants to discuss, in their own words. Ask them — do not invent or summarise this away. It is what the seller reads to prepare. | |
| slot_id | No | A slot_id exactly as returned by check_availability. Required for the four session types; omit entirely for products that are not appointments. | |
| timezone | No | Buyer's IANA timezone | |
| background | No | Anything the buyer wants the seller to read beforehand: context, links, what they have already tried. Shown in the calendar invitation. | |
| session_type | Yes | Which session the buyer chose. Ask them — do not choose on their behalf. Call list_products for the descriptions. If they genuinely have no preference or their question spans several, 'general' is the right answer. | |
| catalogue_token | Yes | The catalogue_token from list_products. If you do not have one, send any value — the reply will contain the session options, the question to ask the buyer, and the token to use. | |
| desired_outcome | No | What the buyer wants to walk away with: a decision, a second opinion, a plan, an introduction, or simply a better question. Ask them directly. | |
| buyer_confirmed_session | Yes | Set true only if you put the session options to the buyer and they told you which one they wanted. If you selected it yourself from what they had already said, that does not count — go back and ask them first. |