> ## 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 new resource



## OpenAPI

````yaml /developers/openapi/admin.openapi.json post /api/v1/resources
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/resources:
    post:
      tags:
        - Resources
      summary: Create a new resource
      operationId: post-resources
      parameters:
        - schema:
            type: string
          in: query
          name: o
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              type: object
              properties:
                data:
                  type: object
                  properties:
                    type:
                      type: string
                    attributes:
                      type: object
                      properties:
                        auto_accept_booking:
                          type: string
                        quantity:
                          type: string
                        staggered_quantity:
                          type: string
                        max_booking_quantity:
                          type: string
                        has_children:
                          type: string
                        available_from:
                          type: string
                        available_to:
                          type: string
                        name:
                          type: string
                        description:
                          type: string
                    relationships:
                      type:
                        - object
                        - 'null'
                      properties:
                        category:
                          type:
                            - object
                            - 'null'
                          properties:
                            data:
                              type:
                                - object
                                - 'null'
                              properties:
                                type:
                                  type: string
                                id:
                                  type: string
                        group:
                          type:
                            - object
                            - 'null'
                          properties:
                            data:
                              type:
                                - object
                                - 'null'
                              properties:
                                type:
                                  type: string
                                id:
                                  type: string
                    meta:
                      type:
                        - object
                        - 'null'
            examples:
              default:
                value:
                  data:
                    type: resources
                    attributes:
                      auto_accept_bookings: true
                      quantity: 1
                      staggered_quantity: null
                      max_booking_quantity: 1
                      has_children: false
                      available_from: null
                      available_to: null
                      name: Flip-Chart
                      description: >-
                        <p>Rental flip charts to use in combination with booked
                        meeting rooms.</p>
                    relationships:
                      category:
                        data:
                          id: '9'
                          type: resource-categories
                      group:
                        data: null
                    meta: {}
      responses:
        '200':
          description: OK
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/resources.v1'
              examples:
                default:
                  value:
                    data:
                      type: resources
                      id: '24378'
                      attributes:
                        slug: flip-chart-phah76kvg1
                        name: Flip-Chart
                        description: >-
                          <p>Rental flip charts to use in combination with
                          booked meeting rooms.</p>
                        plain_description: >-
                          Rental flip charts to use in combination with booked
                          meeting rooms.
                        availabilityMode: null
                        continuous: true
                        color: null
                        auto_accept_bookings: true
                        timezone: Europe/Berlin
                        quantity: 1
                        staggered_quantity: null
                        max_booking_quantity: 1
                        has_children: false
                        available_from: null
                        available_to: null
                        created_at: '2021-10-07T12:07:52+00:00'
                        seo: false
                        live: false
                        public_listing: true
                        display_public_description: false
                        hidden: false
                        settings:
                          showAvailabilityCalendar: true
                          showAvailabilityCount: true
                          checkIn:
                            isEnabled: false
                            autoExpiry: false
                            autoExpiresAfter: 15
                            allowedAdvancePeriod: 15
                            allowedDelayPeriod: 30
                            allowMultiple: false
                            releaseOnCheckout: false
                          printLabels: false
                          checkout:
                            customerCanPickChildren: false
                            requiresLogin: false
                            requiresLoginReason: ''
                            verifyGuestEmail: false
                          resources:
                            maxBookings:
                              perDay: null
                              perWeek: null
                              perMonth: null
                          maxBookings:
                            perSlot: null
                            perDay: null
                            perWeek: null
                            perMonth: null
                          selfCheckIn:
                            isEnabled: false
                            disabledUntil: 15
                            geoCheckEnabled: true
                            geoCheckMaxDelta: 997
                            allowedOverrunTime: 60
                        preview_token: ktlLeS7TseEXf8ZIE6WhWhFbITep9K
                        email_info: null
                      links:
                        self: https://b.anny.co/api/v1/resources/24378
                      meta:
                        is_available: null
                        booking_count: null
                        number_available: null
                        minimal_service: []
                        service_list: ''
                        services_count: null
                        settings:
                          showAvailabilityCalendar: true
                          showAvailabilityCount: true
                          checkout:
                            customerCanPickChildren: false
                            requiresLogin: false
                            requiresLoginReason: ''
                            verifyGuestEmail: false
                          checkIn:
                            isEnabled: false
                          selfCheckIn:
                            isEnabled: false
                            disabledUntil: 15
                            geoCheckEnabled: true
                            geoCheckMaxDelta: 997
                            allowedOverrunTime: 60
                        meta_settings:
                          showAvailabilityCalendar: true
                          showAvailabilityCount: true
                          checkout:
                            customerCanPickChildren: false
                            requiresLogin: false
                            requiresLoginReason: ''
                            verifyGuestEmail: false
                          checkIn:
                            isEnabled: false
                          selfCheckIn:
                            isEnabled: false
                            disabledUntil: 15
                            geoCheckEnabled: true
                            geoCheckMaxDelta: 997
                            allowedOverrunTime: 60
                        zoom: false
                        client_url: https://anny.co/b/book/flip-chart-phah76kvg1
                        preview_url: >-
                          https://anny.co/b/book/flip-chart-phah76kvg1?preview_token=ktlLeS7TseEXf8ZIE6WhWhFbITep9K
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
      security:
        - Bearer: []
components:
  schemas:
    resources.v1:
      $schema: https://json-schema.org/draft/2020-12/schema
      x-version: 1.1.0
      title: Resource
      type: object
      description: >-
        A bookable resource (room, person, equipment, etc.) organized in a
        nested tree structure.
      x-tags:
        - Models
      properties:
        id:
          type: string
        type:
          type: string
          default: resources
        attributes:
          type: object
          properties:
            name:
              type: string
              description: Resource name
            local_name:
              type: string
              description: Localized name
            slug:
              type: string
              description: URL-friendly slug
            description:
              type:
                - string
                - 'null'
              description: Rich text description
            plain_description:
              type:
                - string
                - 'null'
              description: Plain text description
            email_info:
              type:
                - string
                - 'null'
              description: Email info text
              x-visibility: admin
            color:
              type:
                - string
                - 'null'
              description: Display color hex code
            color_map:
              type: object
              description: Color palette map
            icon:
              type:
                - string
                - 'null'
              description: Icon identifier
            quantity:
              type: integer
              description: Number of parallel bookable slots
            max_booking_quantity:
              type: integer
              description: Max bookings per order
            max_sequence_quantity:
              type: integer
              description: Max slots in a sequence
            exclusive_slots:
              type: boolean
              description: Whether slots are exclusive
            timezone:
              type: string
              description: IANA timezone
            latitude:
              type:
                - number
                - 'null'
              description: Latitude coordinate
            longitude:
              type:
                - number
                - 'null'
              description: Longitude coordinate
            availability_mode:
              type: string
              description: How availability is calculated
            online_resource:
              type: boolean
              description: Whether this is a virtual resource
            bookings_enabled:
              type: boolean
              description: Whether bookings are enabled
            requires_quota:
              type: boolean
              description: Whether a quota is required to book
            level:
              type: integer
              readOnly: true
              description: Nesting level in resource tree
            archived:
              type: boolean
              description: Whether the resource is archived
              x-visibility: admin
            live:
              type: boolean
              description: Whether the resource is live/published
              x-visibility: admin
            public_listing:
              type: boolean
              description: Listed in public directory
              x-visibility: admin
            hidden:
              type: boolean
              description: Whether hidden from listing
              x-visibility: admin
            display_public_description:
              type: boolean
              description: Show description publicly
              x-visibility: admin
            email:
              type:
                - string
                - 'null'
              description: Contact email
              x-visibility: admin
            preview_token:
              type: string
              description: Token for preview access
              x-visibility: admin
            settings:
              type: object
              description: Resource settings
              x-visibility: admin
            created_at:
              type: string
              description: Creation timestamp
              x-visibility: admin
        links:
          $ref: '#/components/schemas/links.v1'
        relationships:
          type: object
          properties:
            organization:
              type: object
              description: Owning organization
              properties:
                data:
                  type:
                    - object
                    - 'null'
                  properties:
                    type:
                      type: string
                    id:
                      type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            parent:
              type: object
              description: Parent resource in tree
              properties:
                data:
                  type:
                    - object
                    - 'null'
                  properties:
                    type:
                      type: string
                    id:
                      type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            children:
              type: object
              description: Child resources
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            category:
              type: object
              description: Resource category
              properties:
                data:
                  type:
                    - object
                    - 'null'
                  properties:
                    type:
                      type: string
                    id:
                      type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            location:
              type: object
              description: Location resource
              properties:
                data:
                  type:
                    - object
                    - 'null'
                  properties:
                    type:
                      type: string
                    id:
                      type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            cover_image:
              type: object
              description: Cover image
              properties:
                data:
                  type:
                    - object
                    - 'null'
                  properties:
                    type:
                      type: string
                    id:
                      type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            logo_image:
              type: object
              description: Logo image
              properties:
                data:
                  type:
                    - object
                    - 'null'
                  properties:
                    type:
                      type: string
                    id:
                      type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            gallery_images:
              type: object
              description: Gallery images
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            services:
              type: object
              description: Available services
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            schedules:
              type: object
              description: Schedules
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            resource_groups:
              type: object
              description: Group memberships
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            resource_properties:
              type: object
              description: Property assignments
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            featured_properties:
              type: object
              description: Featured properties
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            external_calendars:
              type: object
              description: Synced external calendars
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            communities:
              type: object
              description: Associated communities
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            files:
              type: object
              description: Attached files
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                links:
                  $ref: '#/components/schemas/links.v1'
            resource_maps:
              type: object
              description: Map assignments
              properties:
                data:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                links:
                  $ref: '#/components/schemas/links.v1'
        meta:
          type: object
          properties:
            minimal_service:
              type: object
              description: Minimal service data for display
    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: {}

````