> ## Documentation Index > Fetch the complete documentation index at: https://docs.anny.co/llms.txt > Use this file to discover all available pages before exploring further. # Create a timeslot ## OpenAPI ````yaml /developers/openapi/admin.openapi.json post /api/v1/timeslots openapi: 3.1.0 info: title: admin-api version: '1.0' description: >- 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](/developers/guides/admin/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](/developers/guides/admin/webhooks), 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](/developers/guides/authentication) 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](/developers/api-reference/customer) --- ## 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 | |---|---| | [Getting Started](/developers) | First steps and quickstart | | [JSON:API Conventions](/developers/guides/json-api-conventions) | Request and response format | | [Authentication](/developers/guides/authentication) | API tokens, OAuth2, scopes | | [Availability & Booking Search](/developers/guides/availability) | Search open slots and timeslots | | [Admin Booking Creation](/developers/guides/admin/booking-creation) | Create bookings from the back office | | [Admin Booking Lifecycle](/developers/guides/admin/booking-lifecycle) | Status changes, check-in, cancellations | | [Invoices](/developers/guides/admin/invoices) | Create, send, and manage invoices | | [Customer Management](/developers/guides/admin/customer-management) | Create and manage customer records | | [Booking Calendars](/developers/guides/admin/calendar-events) | Custom calendar events | | [Timeslot Management](/developers/guides/admin/timeslot-management) | Manage timeslot CRUD, recurrence, allocations, and rescheduling | | [Broadcast Campaigns](/developers/guides/admin/broadcasting) | Email and push campaigns | | [Exports](/developers/guides/admin/exports) | Export bookings and customer data | | [Webhooks & Events](/developers/guides/admin/webhooks) | Subscribe to real-time events | --- ## Base URLs | Environment | URL | |---|---| | Production | `https://b.anny.co` | | Gov-Cloud | `https://b.anny.eu` | contact: name: anny GmbH url: https://anny.co email: support@anny.co servers: - url: https://b.anny.co description: Production - url: https://b.anny.eu description: Gov-Cloud security: - Bearer: [] tags: - name: Add-On Groups - name: Add-Ons - name: Booking Add-Ons - name: Booking Bundles - name: Booking Passes - name: Booking Quota Grants - name: Booking Quotas - name: Booking Rules - name: Bookings - name: Broadcast Campaigns - name: Broadcasts - name: Calendars - name: Cancellation Policies - name: Communities - name: External Links - name: Community Invites - name: Custom Fields - name: Custom Forms - name: Customers - name: Businesses - name: Display Panels - name: Displays - name: Document Templates - name: Exports - name: External Calendars - name: Files - name: Images - name: Invoices - name: Items - name: Legal Document Links - name: Legal Documents - name: Model Identifiers - name: Orders - name: Organizations - name: Payment Setups - name: Payments - name: Plan Subscriptions - name: Price Modifiers - name: Properties - name: Queues - name: Resource Categories - name: Resource Groups - name: Resource Properties - name: Resources - name: Scans - name: Schedule Groups - name: Schedules - name: Service Add-Ons - name: Service Groups - name: Services - name: Sub-Resources - name: Test-Results - name: Test Results - name: Tests - name: Timeslot Allocations - name: Timeslot Series - name: Timeslots - name: User Invites - name: Users - name: Customer Balances - name: Vouchers - name: Webhooks paths: /api/v1/timeslots: post: tags: - Timeslots summary: Create a timeslot operationId: post-timeslots parameters: - schema: type: string in: query name: include description: Optional included relationships to return after create. - schema: type: string in: query name: o description: Organization ID requestBody: content: application/vnd.api+json: schema: type: object properties: data: type: object properties: type: type: string default: timeslots attributes: type: object properties: title: type: - string - 'null' title_i18n: type: object additionalProperties: type: string description: type: - string - 'null' description_i18n: type: object additionalProperties: type: string quota: type: - integer - 'null' min_bookings_count: type: - integer - 'null' cancellation_offset_type: type: - string - 'null' cancellation_offset_value: type: - integer - 'null' dynamic_capacity: type: boolean base_quota: type: - integer - 'null' max_dynamic_quota: type: - integer - 'null' start_date: type: string format: date-time end_date: type: string format: date-time timezone: type: string relationships: type: object properties: resource: type: object properties: data: type: object properties: type: type: string id: type: string service: type: object properties: data: type: object properties: type: type: string id: type: string series: type: object properties: data: type: array items: type: object properties: type: type: string id: type: string meta: type: - object - 'null' examples: create-resource-timeslot: value: data: type: timeslots attributes: title: Session 1 title_i18n: en-us: Session 1 start_date: '2026-06-08T10:00:00+02:00' end_date: '2026-06-08T11:00:00+02:00' max_dynamic_quota: 5 min_bookings_count: 2 cancellation_offset_value: 24 relationships: resource: data: id: '12' type: resources series: data: - id: '3' type: timeslot-series meta: {} description: '' responses: '201': description: Created content: application/vnd.api+json: schema: type: object properties: data: $ref: '#/components/schemas/timeslots.v1' security: - Bearer: [] components: schemas: timeslots.v1: $schema: https://json-schema.org/draft/2020-12/schema x-version: 1.2.0 title: Timeslot type: object description: >- A fixed date-time slot attached to a resource or service. Timeslots can stand alone, belong to one or more timeslot series, and optionally use dynamic capacity driven by provisioned resource allocations. x-tags: - Models properties: id: type: string description: Authenticated admin responses use the internal timeslot ID. type: type: string default: timeslots attributes: type: object properties: title: type: - string - 'null' description: Human-readable timeslot title. title_i18n: type: object additionalProperties: type: string description: Localized title values keyed by locale. description: type: - string - 'null' description: Optional long-form description. description_i18n: type: object additionalProperties: type: string description: Localized description values keyed by locale. start_date: type: string format: date-time description: Start timestamp in ISO 8601. end_date: type: string format: date-time description: End timestamp in ISO 8601. timezone: type: string description: IANA timezone used for UI editing and rescheduling. quota: type: - integer - 'null' description: Effective slot quota after quota calculations. resource_info: type: array description: >- Cached visible provisioned resources used for calendar cards and customer-facing summaries. items: type: object properties: id: type: integer name: type: string slug: type: string category_icon: type: - string - 'null' category_name: type: - string - 'null' category_slug: type: - string - 'null' cover_image_url: type: - string - 'null' created_at: type: string format: date-time description: Creation timestamp. canceled_at: type: - string - 'null' format: date-time description: Cancellation timestamp when the slot has been canceled. min_bookings_count: type: - integer - 'null' description: Minimum accepted bookings required before the slot is confirmed. cancellation_offset_type: type: - string - 'null' description: Time unit for automatic cancellation checks. cancellation_offset_value: type: - integer - 'null' description: Offset value for automatic cancellation checks. dynamic_capacity: type: boolean description: >- Whether quota is computed from base quota plus resource allocations. base_quota: type: integer description: >- Static quota that remains available even without extra allocations. max_dynamic_quota: type: - integer - 'null' description: Upper bound applied to computed quota. links: $ref: '#/components/schemas/links.v1' relationships: type: object properties: resource: type: object description: Primary resource that owns the timeslot. properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' service: type: object description: >- Optional service owner when the slot is service-level instead of resource-level. properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' series: type: object description: Timeslot series attached to this slot. properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' cover_image: type: object description: Optional cover image. properties: data: type: - object - 'null' properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' resource_allocations: type: object description: >- Provisioned or pending resource allocations attached to this slot. properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' model_syncs: type: object description: >- Sync state records for integrations and downstream model sync jobs. properties: data: type: array items: type: object properties: type: type: string id: type: string links: $ref: '#/components/schemas/links.v1' meta: type: object properties: provisioned_quota: type: integer description: >- Quota currently backed by provisioned allocations plus base quota. active_booking_count: type: integer description: Accepted and requested non-blocker booking count. pending_booking_count: type: integer description: In-flight capacity reservations not yet attached to a booking. total_booking_count: type: integer description: Sum of active and pending booking counts. available_provisioned_slots: type: integer description: Remaining slots available from provisioned capacity. pending_capacity: type: integer description: Additional quota still available from pending allocations. protected: type: array description: >- Field names the UI should treat as protected from direct editing. items: type: string links.v1: $schema: https://json-schema.org/draft/2020-12/schema x-version: 1.1.0 title: ResourceLinks x-tags: - Models type: object description: JSON:API self-link object properties: self: type: string format: uri securitySchemes: Bearer: type: oauth2 flows: authorizationCode: authorizationUrl: https://auth.anny.co/oauth/authorize tokenUrl: https://auth.anny.co/oauth/token refreshUrl: https://auth.anny.co/oauth/token/refresh scopes: {} ````