Skip to content
Getting Started

Manage Your API Keys

Create and revoke API keys and read the API documentation so a developer can connect other systems to your school.

By Red Belt Team | Last Update: October 31, 2026

API keys let a developer or another system, such as a check-in kiosk or a custom integration, connect to your Red Belt Gym data. You manage them on the API keys card on the Gym Details page.

Note: Only the gym owner can create and revoke API keys.

Create an API Key

  1. Visit redbeltgym.com.
  2. Sign in to your account.
  3. Click Setup in the left-side menu.
  4. Under Gym & account, click Gym Details.Setup page with the Gym Details tile highlighted
  5. On the API keys card, click New key. The card lists each key's name, status, when it was created and when it was last used.API keys card on the Gym Details page
  6. Enter a Key name you'll recognize later, such as "Zapier", "Website booking" or "Accounting".
  7. Click Generate key.Generate new API key window with the Generate key button highlighted
  8. Copy the key and store it somewhere safe. Keys are shown in full only once, when they're created. After that, only the start and end of the key are shown.

Revoke a Key

Keys don't expire. Revoke a key you no longer use, or one that may have been shared by mistake. Any integration using that key stops working.

  1. On the API keys card, click the three dots next to the key.
  2. Click Revoke key.API key menu with Revoke key

Read the API Documentation

  1. Click API documentation on the API keys card.
  2. The documentation shows the Base URL, the x-api-key authentication header and each endpoint with its parameters and an example request.

Currently the API supports POST /external/check-in, which checks a student in to a class. Send the student's contactId and the classId in the request body. If the student isn't scheduled for that class today, Red Belt Gym schedules them into the class's current or next session automatically.

Frequently Asked Questions

Common Questions & Troubleshooting

I lost my API key. Can I see it again?

No. Keys are shown in full only once. Revoke the lost key from the three-dot menu and create a new one.

Where do I find a contact ID or class ID?

Copy the contact ID from the Contacts list (the short ID under each name has a copy icon). Copy the class ID from Setup › Style & Class (click the ID to copy it).

What does a 401 error mean?

The API key is missing, invalid or revoked. Check the key on the Gym Details page.

What does a 400 error mean?

An ID is missing or invalid, the class wasn't found, the day is a holiday, the contact has no active program, or there is no class session available today.

Is my API key safe to share?

No. Anyone with the key has full access to your gym's data through the API. Share it only with the developer building your integration, and never post it publicly. Red Belt Software will never ask you for it.

Can I connect my website forms instead?

Yes. Use an automation webhook. See our developer instructions for capturing data with a webhook.

See Pricing