Skip to main content

Manage Clubs

Clubs are the foundational units through which you manage your sports organization—be it a soccer club, a swimming team, or a martial arts school. Each club can have many members: athletes, parents, coaches, and volunteers. Properly setting up clubs and managing memberships lays the groundwork for effective coordination of carpooling, events, and internal communication.

This guide demonstrates how to create new clubs, import members, and modify membership records. You’ll also learn about suspending or reactivating a club as needed.

Typical Workflow​

Manage Clubs Flow

1. Create a New Club​

Before you can add members or manage rosters, you need a club record in COOLROOL using the POST /clubs endpoint. Once created, each club can be enriched with details like logo, social media links, and contact information.

curl --request POST \
  --url https://api.coolrool.com/clubs \
  --header 'Authorization: Bearer <ADMIN_TOKEN>' \
  --form 'name=Thunder FC' \
  --form 'zipCode=12345' \
  --form 'country=France' \
  --form 'city=Paris' \
  --form 'address=123 Stadium Road' \
  --form 'email=info@thunderfc.com' \
  --form 'primaryPhone=+33-555-123456'

2. List or Search Existing Clubs​

After creating a club, you or other admins may want to check all available clubs or search for specific ones. COOLROOL offers both paginated and unpaginated listing methods, depending on whether you need quick lookups or structured pagination for large sets of clubs. You can use the GET /clubs endpoint to list all clubs or search for specific ones.

curl --request GET \
  --url "https://api.coolrool.com/clubs?skipPages=0&pageSize=10&searchValue=Thunder" \
  --header 'Authorization: Bearer <TOKEN>'

3. Import Members in Bulk​

When your club has multiple members—like entire teams or entire families—it’s time-consuming to add each one individually, you can use the POST /clubs/member-list-upload endpoint to import them in bulk. By preparing a CSV file of names, phones, and emails, you can swiftly onboard everyone at once.

curl --request POST \
  --url https://api.coolrool.com/clubs/member-list-upload \
  --header 'Authorization: Bearer <ADMIN_TOKEN>' \
  --form 'clubId=1001' \
  --form 'sendEmail=true' \
  --form 'sendSms=true' \
  --form 'csv=@/path/to/members.csv'

Each imported member receives an SMS prompting them to download COOLROOL, which auto-links them to your club.

4. Manage Individual Membership​

Beyond bulk operations, you may need to add a single new member or check someone’s membership details using the POST /clubs/new-membership endpoint. Perhaps a new coach joins mid-season, or a user decides they need to leave the club.

curl --request POST \
  --url https://api.coolrool.com/clubs/new-membership \
  --header 'Authorization: Bearer <ADMIN_TOKEN>' \
  --form 'clubId=1001' \
  --form 'name=Charlie Davis' \
  --form 'phone=+33611122233' \
  --form 'email=charlie@domain.com'
  --form 'isPassenger=true'
  --form 'isDriver=false'

Checking or Deleting Membership​

5. Suspend or Reactivate a Club​

Occasionally, a club may need to be put on hold—for instance, during off-season or financial disputes. By suspending a club, you effectively block new events and memberships until reactivated. This step is admin-only to ensure the feature isn’t misused.

curl --request PATCH \
  --url "https://api.coolrool.com/clubs/suspend/1001?suspendStatus=true" \
  --header 'Authorization: Bearer <ADMIN_TOKEN>'