Getting Started

We enable partners to have their classes booked by our users. Usually, in order to register classes and update their schedule when a user books a class, a partner has to access our Partners’ Portal. But with Booking API it’s possible to add classes’ schedules on Gympass app and website, enabling users to book such classes directly from there, updating the partner’s own schedule automatically.

The regular flow is:

text

With our Booking API, you can leverage a seamless flow integrating your class system with ours, allowing an easier and integrated process for booking:

It allows an easier and integrated process:

text

Authentication

You will need a Client ID and Client Secret provided by Gympass. With these two parameters you can generate your Gympass Auth Token with the curl below (production environment):

request token
1curl -X POST https://identity.gympass.com/auth/realms/master/protocol/openid-connect/token \
2-H 'Content-Type: application/x-www-form-urlencoded' \
3-d 'grant_type=client_credentials&client_id=your-client-id&client_secret=your-client-secret'
  1. The token needs to be sent on all requests;
  2. The token might expire. Currently it has a long expiration time, but Gympass can revogate it at any due to security reasons.So, the recommended implementation is to follow oauth2 pattern (https://www.oauth.com), which is:

Booking API

Once you create classes on your system, Gympass receives the information via Booking API, doing all the work only once and maintaining the information synchronized between applications.

Webhooks

The Gympass webhooks will notify you when specific events are triggered. These notifications are HTTP POST requests to your registered URL. When a Gympass user books a class or releases the booking, we emit an event to the registered webhook and you will have 15 minutes to confirm it.

Environments

Sandbox: https://api.partners.gympass-staging.com
Production: https://api.partners.gympass.com