Send a Peerspace custom offer (invite to book) from an inquiry

1. Open the Peerspace Inbox and the thread with the guest, then click Invite to Book above the messages.
2. Enter the date, time and attendees, then the space rental fee; spaces with a food and beverage minimum also take minimum spend and gratuity.
3. Set the subtotal by hand: Peerspace does not recalculate it when you add or remove hours, and the 8+ hour discount from the Listings tab is not applied to an invite.
4. Click Continue to Add-ons and use Add Item to attach existing add-ons, then Continue to Review Booking, write a note that explains the offer and click Send.
5. Each offer is priced again from scratch. A forgotten discount, sales tax typed in by habit, or the rate of the wrong listing goes out under your name.

Turn Dana's inquiry into a Peerspace offer: Oct 24, 10:00 to 18:00, 20 people, at my events rate with the 8+ hour discount, plus the backdrop add-on. Show me the math before you send it.

1. 01

   Take the terms from the thread

   get_conversation supplies the agreed date, start and end, headcount and anything promised (early setup, a nonprofit price). A missing piece, such as no end time, is asked of you; the agent never fills in a default headcount.

2. 02

   Confirm the slot is still open

   get_calendar for that day catches a booking accepted since the chat began. A clash stops the offer. A pending request from another guest on the same hours is reported, since an accepted offer would collide with it.

3. 03

   Price it the way your listing would

   list_listings gives the base rate of the listing the guest asked about. The agent applies the day or evening rate and the discount you name, and at 8 hours or more takes your 8+ hour percentage off the whole hourly subtotal. Cleaning fees stay undiscounted, and no sales tax is added.

4. 04

   Write a note the guest can check

   The note lists hours, setup time, headcount and each add-on, and states what changed from the guest's first ask. The full calculation is shown to you line by line before anything is sent.

5. 05

   Send once you approve

   send_custom_offer goes out after your OK and the guest gets 7 days to pay. If an earlier offer to the same guest expired, the agent sends a new one only while the booking start is still in the future.

Offer for Dana, Daylight loft, events listing, Fri 24 Oct 10:00 to 18:00, 20 attendees.
8 hours x $150 = $1,200, minus your 15% 8+ hour discount ($180) = $1,020 rental fee.
Add-on: Backdrop set, $50. No sales tax added; Peerspace calculates it.
Note: "Eight hours for your offsite, setup from 9:30, backdrop included."
Sent after your OK. Dana has until Fri 31 Oct to pay.

• A Peerspace guest has 7 days to review and pay an invite-to-book, and if it expires or is declined the host can send another one as long as the booking start time has not passed.
• Peerspace's 8+ hour discount covers the whole booking, not only the hours past 8, and reduces only the hourly rate, never the cleaning fee or other line items.
• Peerspace calculates sales tax on minimum spend and add-ons through Avalara from the host's state, so a host who types tax into an offer charges the guest twice.
• When a guest who already paid for an accepted Peerspace request accepts an invite, Peerspace charges only the difference.
• Peerspace applies its standard service fee to custom-priced offers too, so a lower offer price also lowers the host payout.

send_custom_offer asks for your OK by default. To run it on a schedule without you, switch confirmation off for that tool in your dashboard.

Sources: Peerspace help: How to send a custom offer using the invite-to-book feature · Peerspace help: What is the invite-to-book feature? · Peerspace help: How can I give my guest a discount? · Peerspace help: What is an 8+ hour discount?

curl https://cotlet.dev/api/v1/peerspace/send_custom_offer \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id":"c_58210437","start":"2026-10-24T10:00:00-07:00","end":"2026-10-24T18:00:00-07:00","attendees":20,"rental_fee":1020,"add_on_ids":["ao_backdrop"],"note":"Eight hours for your offsite, setup from 9:30, backdrop included."}'

{
  "offer_id": "o_7731905",
  "conversation_id": "c_58210437",
  "status": "sent",
  "rental_fee": 900,
  "expires_at": "2026-10-18T09:05:00-07:00"
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the tool is peerspace_send_custom_offer. Example data.

• Respond to Peerspace booking requests before they expire
• Answer Peerspace inquiries with your real availability and rules
• Peerspace API and MCP server: every tool
• All use cases