Technical

API Access


Addagio exposes REST API endpoints under /api/ for managing vendors, bookings, services, staff, and more. The API is used internally by the dashboard and can be accessed programmatically on the Business plan.


API routes available


The following route groups exist:


Route groupWhat it does
/api/authAuthentication (sign in, sign up, magic links)
/api/vendorVendor profile management (settings, domain, partner program)
/api/bookingCreate and manage bookings
/api/bookingsList bookings for a vendor
/api/staffStaff member management
/api/teamTeam invites and team member roles
/api/uploadImage uploads (logos, portfolio, products)
/api/reviewSubmit and manage reviews
/api/stripeStripe Connect onboarding and payment management
/api/marketplaceMarketplace search, vendor listings, availability
/api/leadsLead capture and management
/api/analyticsPage view and booking analytics
/api/googleGoogle Calendar integration

Authentication


All vendor API routes require an active session. The system uses cookie-based auth. For programmatic access, send requests with your session cookie.


Marketplace API (public)


These endpoints do not require authentication:


  • GET /api/marketplace/search?q=&category=&city=&page= — Search vendors. Returns vendors where marketplaceListed=true, marketplaceStatus=APPROVED, and isActive=true.
  • GET /api/marketplace/vendors/[slug] — Get a single vendor's full profile including services, staff, reviews, menu items, and theme.
  • GET /api/marketplace/vendors/[slug]/availability — Check available time slots for a date and party size.

  • Vendor API (authenticated)


  • POST /api/vendor/domain — Set or remove custom domain
  • POST /api/vendor/partner — Submit partner program application (website, tier, link URL)
  • POST /api/vendor/partner/activate — Activate partner free months after verification

  • Booking API


  • POST /api/booking — Create a new booking with service, staff, date/time, and customer info
  • GET /api/bookings — List bookings for the authenticated vendor

  • Webhooks


    Webhook support is available for real-time notifications when events occur (booking.created, booking.cancelled, payment.received). Contact support to configure webhook endpoints.


    Rate limits and access


    API access is included on all plans. The marketplace search API is public and does not require authentication. Vendor management APIs require a valid session.

    APIdeveloperintegrationwebhookREST