> ## Documentation Index
> Fetch the complete documentation index at: https://www.spacebring.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Guides

> Guides for certifying your integration with Spacebring

To ensure a smooth and compliant integration, all partners must follow Spacebring's [Terms of Use](https://www.spacebring.com/terms) and adhere to the relevant integration guidelines outlined below.

## Requirements

<Tabs>
  <Tab title="Marketplace">
    The most common integration scenario between a booking aggregator marketplace and Spacebring involves displaying room and desk availability on the marketplace, enabling users to book directly from the marketplace, and synchronizing these bookings with Spacebring to reserve the space and manage access permissions.

    1. **Authentication.** Implement [OAuth2](/api-reference/authentication#oauth2) to connect the integration.
    2. **Multi-Location.** Resources are grouped by location. Consider this structure when retrieving resources and their availability to ensure accurate and efficient data handling and presentation.
    3. **Booking Owner.** For each booking, include the real booking owner. Spacebring differentiates between members and nonmembers. The best practice is to first [retrieve memberships](/api-reference/memberships/retrieve-memberships) to obtain `membershipRef`, and if not found then create a nonmember by setting `membership.type` value to `nonmember`.
       <Tip>Assigning all bookings to the account of the administrator who connected Spacebring to your app is prohibited and results in a degraded user experience.</Tip>
  </Tab>

  <Tab title="Access control">
    The most common integration scenario between an access control solution and Spacebring is to grant door access based on subscriptions, room and desk bookings.

    1. **Authentication.** Implement [OAuth2](/api-reference/authentication#oauth2) to connect the integration.
    2. **Mapping.** Implement logic enabling administrators to associate locations and resources on Spacebring with corresponding sites and access groups within your system.
    3. **Access Conditions.** Take into consideration the following:
       * Users may have an individual subscription or belong to a company with a subscription.
       * Bookings may vary in duration, from as short as 5 minutes up to 24 hours. Users may create multiple bookings for the same resource (e.g., book a meeting room several times in a row.)
       * Access to a meeting room for a nonmember may require opening several locks on the way to the room, for example the main door, elevator, and meeting room door.
  </Tab>
</Tabs>

## Certification

Once your integration is complete, please contact us at [api@spacebring.com](mailto:api@spacebring.com) to initiate the certification process. Please provide all necessary details we might require to test your integration.