For the complete documentation index, see llms.txt.

POST /v1/offers

Create Offer

Deprecated

**Deprecated.** The legacy appointment-offers runtime was retired in Wave 6 of the proposals rebuild. The route is no longer mounted and returns 404. Use `POST /v1/proposals` instead — it's the system of record for two-party meeting negotiation. --- Create a new appointment offer. Sends an email to the customer with a specific time slot to accept or decline.

Auth required: Yes

Parameters

• Idempotency-Key (header, string) — Unique key for idempotent POST requests (1-256 chars: alphanumeric, `_`, `-`, `:`, `.`). Same key + same body within 24h replays the cached response.

Request Body

• customer_id: string (required)
• proposed_start_time: string (required)
• proposed_end_time: string (required)
• message: string

Responses

• 201: Offer created and email sent
• 400: Validation error
• 401: Authentication required or invalid
• 409: A request with this Idempotency-Key is currently being processed
• 422: Idempotency-Key was already used with a different request body

Authentication

Requires authentication. Pass a Bearer token (Supabase JWT) or an API key (`Authorization: Bearer vennio_sk_live_*`) in the request headers.

Base URL: https://api.vennio.app