# Vennio API Documentation

> Vennio provides AI-native scheduling infrastructure that makes time programmable. Build scheduling features into any product — availability queries, direct bookings, paid bookings via Stripe, webhook events, and multi-provider calendar sync (Google Calendar, Microsoft 365).

> Base URL: https://api.vennio.app
> API Version: 1.4.0

## Docs
- [Introduction](https://docs.vennio.app/overview/introduction.md)
- [Authentication](https://docs.vennio.app/overview/authentication.md)
- [Onboarding](https://docs.vennio.app/overview/onboarding.md)
- [Quick Start](https://docs.vennio.app/overview/quickstart.md)
- [Rate Limits & Errors](https://docs.vennio.app/overview/rate-limits.md)
- [Webhooks](https://docs.vennio.app/overview/webhooks.md)
- [Paid Bookings](https://docs.vennio.app/overview/paid-bookings.md)
- [Pricing & Billing](https://docs.vennio.app/overview/pricing.md)

## Guides
- [AI Agent Integration (MCP)](https://docs.vennio.app/guides/mcp-integration.md)
- [Firecrawl + Vennio MCP](https://docs.vennio.app/guides/firecrawl-integration.md)
- [How Vennio is different](https://docs.vennio.app/guides/how-vennio-is-different.md)
- [Team Scheduling](https://docs.vennio.app/guides/team-scheduling.md)
- [Recurring Bookings](https://docs.vennio.app/guides/recurring-bookings.md)
- [CLI](https://docs.vennio.app/guides/cli.md)
- [Booking Widget](https://docs.vennio.app/guides/booking-widget.md)
- [Availability Picker](https://docs.vennio.app/guides/availability-picker.md)

## FAQ
- [How do I add scheduling to my app?](https://docs.vennio.app/faq/add-scheduling-to-app.md)
- [Best scheduling API for developers?](https://docs.vennio.app/faq/best-scheduling-api.md)
- [How can AI agents schedule meetings?](https://docs.vennio.app/faq/ai-agents-schedule-meetings.md)
- [How to prevent double-bookings?](https://docs.vennio.app/faq/prevent-double-bookings.md)
- [How to build a Calendly alternative?](https://docs.vennio.app/faq/build-calendly-alternative.md)

## SDKs & Tools
- [JavaScript SDK](https://docs.vennio.app/sdks/javascript.md)
- [Python Quickstart](https://docs.vennio.app/sdks/python.md)
- [React Components](https://docs.vennio.app/sdks/react.md)

## Changelog
- [Changelog](https://docs.vennio.app/changelog.md)

## API Reference

### Discovery
- [Discovery Overview](https://docs.vennio.app/api/discovery.md): AI agent discovery endpoints for machine-readable API capabilities.
- [AI Agent Discovery](https://docs.vennio.app/api/discovery/discoveragentcapabilities.md): GET /.well-known/ai-agent
- [OpenAPI Specification (YAML)](https://docs.vennio.app/api/discovery/getopenapiyaml.md): GET /openapi.yaml
- [OpenAPI Specification (JSON)](https://docs.vennio.app/api/discovery/getopenapijson.md): GET /openapi.json

### Platform APIs
- [Platform APIs Overview](https://docs.vennio.app/api/platform-apis.md): Direct booking and availability APIs - core platform primitives.
- [List Bookings](https://docs.vennio.app/api/platform-apis/listbookings.md): GET /v1/bookings
- [Create Direct Booking](https://docs.vennio.app/api/platform-apis/createdirectbooking.md): POST /v1/bookings
- [Get Booking Details](https://docs.vennio.app/api/platform-apis/getbooking.md): GET /v1/bookings/{id}
- [Update Booking](https://docs.vennio.app/api/platform-apis/updatebooking.md): PATCH /v1/bookings/{id}
- [Cancel Booking](https://docs.vennio.app/api/platform-apis/cancelbooking.md): DELETE /v1/bookings/{id}
- [Get Booking Statistics](https://docs.vennio.app/api/platform-apis/getbookingstats.md): GET /v1/bookings/stats
- [List Booking Series](https://docs.vennio.app/api/platform-apis/listbookingseries.md): GET /v1/booking-series
- [Get Booking Series](https://docs.vennio.app/api/platform-apis/getbookingseries.md): GET /v1/booking-series/{id}
- [Get Available Time Slots](https://docs.vennio.app/api/platform-apis/getavailabilityslots.md): GET /v1/availability/slots
- [Get Next Available Slot](https://docs.vennio.app/api/platform-apis/getnextavailableslot.md): GET /v1/availability/next
- [Find Mutual Availability](https://docs.vennio.app/api/platform-apis/getmutualavailability.md): GET /v1/availability/mutual
- [Get Principal Availability](https://docs.vennio.app/api/platform-apis/getprincipalavailability.md): GET /v1/principals/{principalId}/availability

### Venn Links
- [Venn Links Overview](https://docs.vennio.app/api/venn-links.md): Shareable booking links (like Calendly).
- [List Venn Links](https://docs.vennio.app/api/venn-links/listvennlinks.md): GET /v1/venn-links
- [Create Venn Link](https://docs.vennio.app/api/venn-links/createvennlink.md): POST /v1/venn-links
- [Get Venn Link by Short Code](https://docs.vennio.app/api/venn-links/getvennlinkbyshortcode.md): GET /v1/venn-links/{identifier}
- [Update Venn Link](https://docs.vennio.app/api/venn-links/updatevennlink.md): PUT /v1/venn-links/{identifier}
- [Delete Venn Link](https://docs.vennio.app/api/venn-links/deletevennlink.md): DELETE /v1/venn-links/{identifier}
- [Get Venn Link Availability](https://docs.vennio.app/api/venn-links/getvennlinkavailability.md): GET /v1/venn-links/{identifier}/availability
- [Book via Venn Link](https://docs.vennio.app/api/venn-links/bookviavennlink.md): POST /v1/venn-links/{identifier}/book
- [Get Venn Link Bookings](https://docs.vennio.app/api/venn-links/getvennlinkbookings.md): GET /v1/venn-links/{identifier}/bookings

### Calendars
- [Calendars Overview](https://docs.vennio.app/api/calendars.md): Connect and manage calendar integrations with multi-provider support.
- [List Connected Calendars](https://docs.vennio.app/api/calendars/listcalendars.md): GET /v1/calendars
- [Get Calendar Selections](https://docs.vennio.app/api/calendars/getcalendarselection.md): GET /v1/calendars/selection
- [Save Calendar Selections](https://docs.vennio.app/api/calendars/savecalendarselection.md): PUT /v1/calendars/selection
- [Initiate Google OAuth](https://docs.vennio.app/api/calendars/connectgooglecalendar.md): GET /v1/calendars/google/connect
- [Google OAuth Callback](https://docs.vennio.app/api/calendars/googleoauthcallback.md): GET /v1/calendars/google/callback
- [Exchange Google Auth Code](https://docs.vennio.app/api/calendars/exchangegooglecode.md): POST /v1/calendars/google/exchange
- [Initiate Microsoft OAuth](https://docs.vennio.app/api/calendars/connectmicrosoftcalendar.md): GET /v1/calendars/microsoft/connect
- [Microsoft OAuth Callback](https://docs.vennio.app/api/calendars/microsoftoauthcallback.md): GET /v1/calendars/microsoft/callback
- [Setup Calendar Webhooks](https://docs.vennio.app/api/calendars/setupcalendarwebhooks.md): POST /v1/calendars/setup-webhooks
- [Calendar Webhook Receiver](https://docs.vennio.app/api/calendars/receivecalendarwebhook.md): POST /v1/calendars/webhook
- [Sync Calendars](https://docs.vennio.app/api/calendars/synccalendars.md): POST /v1/calendars/sync
- [Disconnect Calendar Provider](https://docs.vennio.app/api/calendars/disconnectcalendar.md): DELETE /v1/calendars/disconnect

### Network
- [Network Overview](https://docs.vennio.app/api/network.md): Manage your business network and stakeholder relationships.
- [Get Network Overview](https://docs.vennio.app/api/network/getnetworkoverview.md): GET /v1/network
- [List Network Connections](https://docs.vennio.app/api/network/listnetworkconnections.md): GET /v1/network/connections
- [Find Mutual Connections](https://docs.vennio.app/api/network/findmutualconnections.md): GET /v1/network/mutual
- [Get Network Stats](https://docs.vennio.app/api/network/getnetworkstats.md): GET /v1/network/stats
- [List Invitations](https://docs.vennio.app/api/network/listinvitations.md): GET /v1/invitations
- [Send Invitation](https://docs.vennio.app/api/network/createinvitation.md): POST /v1/invitations
- [Send Bulk Invitations](https://docs.vennio.app/api/network/createbulkinvitations.md): POST /v1/invitations/bulk
- [Get Invitation](https://docs.vennio.app/api/network/getinvitation.md): GET /v1/invitations/{id}
- [Update Invitation](https://docs.vennio.app/api/network/updateinvitation.md): PATCH /v1/invitations/{id}
- [Cancel Invitation](https://docs.vennio.app/api/network/cancelinvitation.md): DELETE /v1/invitations/{id}
- [Resend Invitation Email](https://docs.vennio.app/api/network/resendinvitation.md): POST /v1/invitations/{id}/resend
- [Get Invitation Details (Public)](https://docs.vennio.app/api/network/getinvitationbytoken.md): GET /v1/invitations/accept/{token}
- [Accept Invitation (Public)](https://docs.vennio.app/api/network/acceptinvitation.md): POST /v1/invitations/accept/{token}
- [Decline Invitation (Public)](https://docs.vennio.app/api/network/declineinvitation.md): POST /v1/invitations/decline/{token}
- [List Access Requests](https://docs.vennio.app/api/network/listaccessrequests.md): GET /v1/access-requests
- [Create Access Request](https://docs.vennio.app/api/network/createaccessrequest.md): POST /v1/access-requests
- [Get Access Request](https://docs.vennio.app/api/network/getaccessrequest.md): GET /v1/access-requests/{id}
- [Respond to Access Request](https://docs.vennio.app/api/network/respondtoaccessrequest.md): PATCH /v1/access-requests/{id}
- [Cancel Access Request](https://docs.vennio.app/api/network/cancelaccessrequest.md): DELETE /v1/access-requests/{id}

### HubSpot
- [HubSpot Overview](https://docs.vennio.app/api/hubspot.md): HubSpot CRM integration for contact import and sync.
- [Get HubSpot OAuth URL](https://docs.vennio.app/api/hubspot/gethubspotauthurl.md): GET /v1/hubspot/auth-url
- [HubSpot OAuth Callback](https://docs.vennio.app/api/hubspot/hubspotoauthcallback.md): POST /v1/hubspot/callback
- [Get HubSpot Connection Status](https://docs.vennio.app/api/hubspot/gethubspotconnection.md): GET /v1/hubspot/connection
- [Disconnect HubSpot](https://docs.vennio.app/api/hubspot/disconnecthubspot.md): DELETE /v1/hubspot/connection
- [List HubSpot Contacts](https://docs.vennio.app/api/hubspot/listhubspotcontacts.md): GET /v1/hubspot/contacts
- [Search HubSpot Contacts](https://docs.vennio.app/api/hubspot/searchhubspotcontacts.md): POST /v1/hubspot/contacts/search
- [Get HubSpot Contact Count](https://docs.vennio.app/api/hubspot/gethubspotcontactcount.md): GET /v1/hubspot/contacts/count
- [Start Bulk Import](https://docs.vennio.app/api/hubspot/starthubspotbulkimport.md): POST /v1/hubspot/import-all
- [Get Import Job Status](https://docs.vennio.app/api/hubspot/gethubspotimportjobstatus.md): GET /v1/hubspot/import-jobs/{jobId}

### Salesforce
- [Salesforce Overview](https://docs.vennio.app/api/salesforce.md): Salesforce CRM integration for booking sync.
- [Initiate Salesforce OAuth](https://docs.vennio.app/api/salesforce/connectsalesforce.md): GET /v1/salesforce/connect
- [Salesforce OAuth Callback](https://docs.vennio.app/api/salesforce/salesforceoauthcallback.md): GET /v1/salesforce/callback
- [Get Salesforce Connection Status](https://docs.vennio.app/api/salesforce/getsalesforcestatus.md): GET /v1/salesforce/status
- [Disconnect Salesforce](https://docs.vennio.app/api/salesforce/disconnectsalesforce.md): POST /v1/salesforce/disconnect
- [Update Salesforce Settings](https://docs.vennio.app/api/salesforce/updatesalesforcesettings.md): PATCH /v1/salesforce/settings
- [Sync All Bookings to Salesforce](https://docs.vennio.app/api/salesforce/syncalltosalesforce.md): POST /v1/salesforce/sync
- [Sync Specific Booking to Salesforce](https://docs.vennio.app/api/salesforce/syncbookingtosalesforce.md): POST /v1/salesforce/sync/{bookingId}

### Schedules
- [Schedules Overview](https://docs.vennio.app/api/schedules.md): Named weekly availability patterns with date-specific overrides.
- [List Schedules](https://docs.vennio.app/api/schedules/listschedules.md): GET /v1/schedules
- [Create Schedule](https://docs.vennio.app/api/schedules/createschedule.md): POST /v1/schedules
- [Get Schedule](https://docs.vennio.app/api/schedules/getschedule.md): GET /v1/schedules/{id}
- [Update Schedule](https://docs.vennio.app/api/schedules/updateschedule.md): PATCH /v1/schedules/{id}
- [Delete Schedule](https://docs.vennio.app/api/schedules/deleteschedule.md): DELETE /v1/schedules/{id}
- [List Schedule Overrides](https://docs.vennio.app/api/schedules/listscheduleoverrides.md): GET /v1/schedules/{id}/overrides
- [Create Schedule Override](https://docs.vennio.app/api/schedules/createscheduleoverride.md): POST /v1/schedules/{id}/overrides
- [Delete Schedule Override](https://docs.vennio.app/api/schedules/deletescheduleoverride.md): DELETE /v1/schedules/{id}/overrides/{overrideId}

### Event Types
- [Event Types Overview](https://docs.vennio.app/api/event-types.md): Reusable booking templates that Venn Links can inherit from.
- [List Event Types](https://docs.vennio.app/api/event-types/listeventtypes.md): GET /v1/event-types
- [Create Event Type](https://docs.vennio.app/api/event-types/createeventtype.md): POST /v1/event-types
- [Get Event Type](https://docs.vennio.app/api/event-types/geteventtype.md): GET /v1/event-types/{id}
- [Update Event Type](https://docs.vennio.app/api/event-types/updateeventtype.md): PATCH /v1/event-types/{id}
- [Delete Event Type](https://docs.vennio.app/api/event-types/deleteeventtype.md): DELETE /v1/event-types/{id}

### Consents
- [Consents Overview](https://docs.vennio.app/api/consents.md): Manage customer calendar access permissions.
- [List Consents](https://docs.vennio.app/api/consents/listconsents.md): GET /v1/consents
- [Create Consent](https://docs.vennio.app/api/consents/createconsent.md): POST /v1/consents
- [Get Consent Details](https://docs.vennio.app/api/consents/getconsent.md): GET /v1/consents/{id}
- [Revoke Consent](https://docs.vennio.app/api/consents/revokeconsent.md): DELETE /v1/consents/{id}

### Proposals
- [Proposals Overview](https://docs.vennio.app/api/proposals.md): Multi-party meeting proposals with threaded negotiation.
- [List Proposals](https://docs.vennio.app/api/proposals/listproposals.md): GET /v1/proposals
- [Create Proposal](https://docs.vennio.app/api/proposals/createproposal.md): POST /v1/proposals
- [Get Proposal Details](https://docs.vennio.app/api/proposals/getproposal.md): GET /v1/proposals/{id}
- [Respond to Proposal](https://docs.vennio.app/api/proposals/respondtoproposal.md): POST /v1/proposals/{id}/response
- [Get Proposal Thread](https://docs.vennio.app/api/proposals/getproposalthread.md): GET /v1/proposals/{id}/thread

### Teams
- [Teams Overview](https://docs.vennio.app/api/teams.md): Persistent team scheduling with cross-organisational members.
- [List Teams](https://docs.vennio.app/api/teams/listteams.md): GET /v1/teams
- [Create Team](https://docs.vennio.app/api/teams/createteam.md): POST /v1/teams
- [Get Team](https://docs.vennio.app/api/teams/getteam.md): GET /v1/teams/{id}
- [Update Team](https://docs.vennio.app/api/teams/updateteam.md): PATCH /v1/teams/{id}
- [Delete Team](https://docs.vennio.app/api/teams/deleteteam.md): DELETE /v1/teams/{id}
- [Add Team Member](https://docs.vennio.app/api/teams/addteammember.md): POST /v1/teams/{id}/members
- [Get Team Member](https://docs.vennio.app/api/teams/getteammember.md): GET /v1/teams/{id}/members/{memberId}
- [Remove Team Member](https://docs.vennio.app/api/teams/removeteammember.md): DELETE /v1/teams/{id}/members/{memberId}
- [Get Team Availability](https://docs.vennio.app/api/teams/getteamavailability.md): GET /v1/teams/{id}/availability
- [Create Team Proposal](https://docs.vennio.app/api/teams/createteamproposal.md): POST /v1/teams/{id}/proposals

### Offers
- [Offers Overview](https://docs.vennio.app/api/offers.md): Direct appointment offers for immediate booking.
- [List Offers](https://docs.vennio.app/api/offers/listoffers.md): GET /v1/offers
- [Create Offer](https://docs.vennio.app/api/offers/createoffer.md): POST /v1/offers
- [Respond to Offer](https://docs.vennio.app/api/offers/respondtooffer.md): POST /v1/offers/{id}/respond

### Webhooks
- [Webhooks Overview](https://docs.vennio.app/api/webhooks.md): Subscribe to real-time booking events with production-grade delivery guarantees.
- [List Webhooks](https://docs.vennio.app/api/webhooks/listwebhooks.md): GET /v1/webhooks
- [Create Webhook](https://docs.vennio.app/api/webhooks/createwebhook.md): POST /v1/webhooks
- [Get Webhook](https://docs.vennio.app/api/webhooks/getwebhook.md): GET /v1/webhooks/{id}
- [Update Webhook](https://docs.vennio.app/api/webhooks/updatewebhook.md): PUT /v1/webhooks/{id}
- [Delete Webhook](https://docs.vennio.app/api/webhooks/deletewebhook.md): DELETE /v1/webhooks/{id}
- [Regenerate Webhook Secret](https://docs.vennio.app/api/webhooks/regeneratewebhooksecret.md): POST /v1/webhooks/{id}/regenerate-secret
- [Send Test Webhook](https://docs.vennio.app/api/webhooks/sendtestwebhook.md): POST /v1/webhooks/{id}/test
- [Get Webhook Deliveries](https://docs.vennio.app/api/webhooks/getwebhookdeliveries.md): GET /v1/webhooks/{id}/deliveries

### API Keys
- [API Keys Overview](https://docs.vennio.app/api/api-keys.md): Manage API keys for programmatic access.
- [List API Keys](https://docs.vennio.app/api/api-keys/listapikeys.md): GET /v1/api-keys
- [Create API Key](https://docs.vennio.app/api/api-keys/createapikey.md): POST /v1/api-keys
- [Revoke API Key](https://docs.vennio.app/api/api-keys/revokeapikey.md): DELETE /v1/api-keys/{keyId}
- [Get API Key Statistics](https://docs.vennio.app/api/api-keys/getapikeystats.md): GET /v1/api-keys/{keyId}/stats

### MCP
- [MCP Overview](https://docs.vennio.app/api/mcp.md): Model Context Protocol (MCP) endpoint for AI agent tool access.
- [MCP JSON-RPC endpoint](https://docs.vennio.app/api/mcp/mcpjsonrpc.md): POST /mcp

### Widgets
- [Widgets Overview](https://docs.vennio.app/api/widgets.md): Embeddable widgets for growth hacking and viral distribution.
- [Get Email Signature Badge](https://docs.vennio.app/api/widgets/getbadge.md): GET /api/v1/badge/{shortCode}
- [Get Email Signature Badge (SVG extension)](https://docs.vennio.app/api/widgets/getbadgesvg.md): GET /api/v1/badge/{shortCode}.svg

### Stripe
- [Stripe Overview](https://docs.vennio.app/api/stripe.md): Stripe Connect integration for paid bookings.
- [Create Stripe Connected Account](https://docs.vennio.app/api/stripe/createstripeconnect.md): POST /v1/stripe/connect
- [Create Account Session](https://docs.vennio.app/api/stripe/createstripeaccountsession.md): POST /v1/stripe/account-session
- [Get Stripe Account Status](https://docs.vennio.app/api/stripe/getstripeaccount.md): GET /v1/stripe/account
- [Disconnect Stripe Account](https://docs.vennio.app/api/stripe/disconnectstripe.md): DELETE /v1/stripe/disconnect
- [Stripe Webhook](https://docs.vennio.app/api/stripe/handlestripewebhook.md): POST /v1/stripe/webhook

### Billing
- [Billing Overview](https://docs.vennio.app/api/billing.md): Platform subscription management for Vennio developer plans.
- [Create Billing Checkout Session](https://docs.vennio.app/api/billing/createbillingcheckout.md): POST /v1/billing/checkout
- [Get Subscription Status](https://docs.vennio.app/api/billing/getbillingsubscription.md): GET /v1/billing/subscription
- [Get Billing Status](https://docs.vennio.app/api/billing/getbillingstatus.md): GET /v1/billing/status
- [Get Billing Usage](https://docs.vennio.app/api/billing/getbillingusage.md): GET /v1/billing/usage
- [Create Customer Portal Session](https://docs.vennio.app/api/billing/createbillingportal.md): POST /v1/billing/portal

### Audit Leads
- [Audit Leads Overview](https://docs.vennio.app/api/audit-leads.md): Lead capture from the Scheduling Health Check audit tool at vennio.app/audit.
- [Submit Audit Lead](https://docs.vennio.app/api/audit-leads/createauditlead.md): POST /v1/audit-leads

## Optional
- [Full documentation as plain text](https://docs.vennio.app/llms-full.txt): Complete API docs — all guides and endpoint reference in a single file
- [OpenAPI specification](https://api.vennio.app/v1/openapi.yaml): Machine-readable API spec (YAML)