v1.0
OAS 3.1.0

admin-api

The Admin API gives you full programmatic access to your anny organization. It is built for server-side integrations — backend services, automation scripts, and custom tooling that act on behalf of your team.


When to use the Admin API

Use the Admin API when you need to drive workflows from your own systems:

  • Sync membership data — create or update customers, assign them to communities, reflect subscription status from an external CRM
  • Create bookings programmatically — build back-office tools or automate repeat reservations without going through the customer checkout
  • Issue and forward invoices — generate invoices, send them to customers, or push them to your accounting system
  • React to real-time events — pair the API with Webhooks to trigger side effects whenever a booking is created, cancelled, or checked in
  • Drive display panels — push live occupancy and schedule data to digital signage or lobby displays

Combined with webhook subscriptions, you can build fully automated, event-driven workflows without polling.


Authentication

Generate a long-lived API token directly in the admin dashboard under Organization Settings → API. All requests require it in the Authorization header:

Authorization: Bearer {access_token}

Every endpoint is organization-scoped. Pass your organization ID as a query parameter on every request:

?o={organization_id}

See the Authentication guide for token scopes and the full OAuth2 flow.


Admin API vs Customer API

Admin API Customer API
Use case Server-side automation, backend tooling End-user apps, booking widgets
Auth Required — API token or OAuth2 Optional — many endpoints work without a token
Identifiers Immutable UUIDs and integer IDs Slugs, booking numbers, order numbers
Access Full read/write Public and customer-owned data only

Go to the Customer API


Resource Identifiers

The Admin API uses immutable IDs — UUIDs for most entities, integers for legacy ones. These are safe to store in external systems and never change, even if an organization renames a resource.


Starting Points

Guide What it covers
Authentication API tokens, OAuth2, scopes
Admin Booking Creation Create bookings from the back office
Admin Booking Lifecycle Status changes, check-in, cancellations
Webhooks & Events Subscribe to real-time events
Customer Management Create and manage customer records

Base URLs

Environment URL
Production https://b.anny.co
Gov-Cloud https://b.anny.eu
Staging https://b.staging.anny.co

Production

Client Libraries