Extentions for aggregator bookings
      Back to home
      1. Help Center
      2. Market: extensions & interfaces
      3. Extentions for aggregator bookings

      Activate the Urban Sports Club API

      Connect your Eversports Manager with Urban Sports Club to sync schedules and manage bookings

      With the Urban Sports Club (USC) API integration, your schedule is automatically synchronised between Eversports Manager and Urban Sports Club. Bookings and cancellations are transferred in real-time, making management easier and more efficient. 

      1. Activate the Urban Sports Club Extension

      To get started: 

      • Navigate to the Market menu (bottom left in your Eversports Manager)
      • Select Urban Sports Club API and click Learn more. 
      • Follow the activation steps.
      • You will receive a confirmation email with further information. 

      2. Enable Activities for Urban Sports Club

      You can choose which activities (classes or trainings) are available on Urban Sports Club: 

      1. Go to the relevant activity settings
         
      2. Open the Rules tab.

      3. Under Aggregator bookings, select "Allow bookings from aggregators" to enable the activity for USC. 

      4. Optionally, you can limit the number of spots available for bookings from aggregators.

      3. Inform Urban Sports Club Support

      After enabling your first activities:

      • Contact the Urban Sports Club API support team to finalise the connection.
        The USC API support team will link your Eversports Manager to your USC API account. 
      • You will need to send the Location UUIDs for all locations you wish to link.

      To find your Location UUIDs:

      1. Go to Settings > Aggregators.

        image-png-Jan-23-2025-09-14-35-4522-AM-1
      2. Copy the Location UUIDs using the copy button provided.

      3. Paste the UUIDs into the designated typeform.

      You'll be notified as soon as the USC installation is complete.

      Important: If you have duplicate locations or unused locations, please contact our customer service (support@eversports.com) so that we can merge them.

      4. How the API Works

      Once your Urban Sports Club API connection is complete, the following processes are automated:

      Synchronize activities

      All classes or trainings marked as available for aggregators are automatically synced with Urbans Sports Club - no need to manage your schedule twice.

      Bookings & Cancellations Sync

      When a USC customer books or cancels via the USC API:

      • The booking and cancellation is transferred directly into your Eversports Manager.
      • These appear in the same activity list as your regular bookings.
      • The product "Urban Sports Club API" is automatically assigned and cannot be deleted manually from the activity. 

      Customer Creation via the API

      • When someones books via USC:
        • A customer profile is created in your Eversports Manager 
        • The aggregator ID is saved in the profile to match all future bookings from the same user.

      • If a customer already exists in your system:
        • You can manually add the USC ID:
          1. Go to the customer profile
          2. In the Details tab, find Customer IDs from aggregators.
          3. Click the three dots and enter the USC ID.

      This ensures future bookings are assigned to the existing profile instead of creating duplicates.

      5. Other information on the USC API

      1. Adding Sport Types

      If you plan to add new sport types in your Eversports Manager and create activities with this sport types, please inform the USC team in advance. This ensures that all activities are properly synchronized.

      2. Cancellation Deadlines for USC Members

      Eversports automatically shares your cancellation conditions with USC via the API. In general, USC adopts your existing cancellation deadlines.

      However, please note:

      • If your cancellation deadline is less than or equal to 12 hours, it will remain the same for USC members.

      • If your cancellation deadline exceeds 12 hours, USC will automatically reduce it to 12 hours, as per their general policy for all members.

      3. Synchronization between Eversports and USC

      • USC synchronizes information from the Eversports API every 30 minutes, so changes in your Eversports Manager should reflect on USC within that timeframe.

      • Bookings and cancellations are updated in real time.

      4. When Are Classes Cancelled on USC?

      If you make specific changes to your classes in Eversports, USC will automatically cancel those classes for their members. This happens in the following cases:

      • When you change the teacher of a class in Eversports
      • When you change the time of a class in Eversports

      Please keep this in mind - USC members will need to rebook the class after these changes.

      5. How Do Activity Descriptions from Eversports Appear on USC?

      USC imports your class and activity descriptions directly from Eversports. However, their system currently does not support HTML formatting.

      This means any HTML tags (like bold text, headings, or special formatting) are removed. The description might appear as one long, unformatted sentence.