List User Favorites
Authentication
RequiredResponse Fields
Full club object (uses ClubListSerializer)
User ID (hidden in response)
When club was favorited
Example Request
Example Response
Favorite a Club
Authentication
RequiredRequest Body
Club code to favorite
Response
Returns the created favorite objectExample Request
Example Response
Unfavorite a Club
Authentication
RequiredPath Parameters
Favorite ID
Response
Returns 204 No Content on successExample Request
Get Favorite Events Calendar
Authentication
RequiredResponse
Returns iCalendar (.ics) format feed containing events from all favorited clubsExample Request
List User Subscriptions
Authentication
RequiredResponse Fields
Full club object
User ID (hidden)
When user subscribed
Example Request
Example Response
Subscribe to Club
Authentication
RequiredRequest Body
Club code to subscribe to
Response
Returns the created subscription objectNotes
- Club must have
enables_subscription: true - User’s email will be visible to club officers
- Club can send recruitment and event updates to subscribers
Example Request
Unsubscribe from Club
Authentication
RequiredPath Parameters
Subscription ID
Response
Returns 204 No Content on successExample Request
View Club Subscribers
Authentication
Required - must be club officer or ownerPath Parameters
Club code identifier
Response Fields
Subscriber’s full name
Subscriber’s username
Subscriber’s email address
Array of school objects
Array of major objects
Expected graduation year
When user subscribed
Example Request
Example Response
Favorites vs Subscriptions
Favorites
- Purpose: Personal bookmarking/following clubs
- Visibility: Private to the user
- Data Shared: None - clubs don’t see who favorited them
- Use Case: Keep track of clubs you’re interested in
- Features:
- Appears in “My Clubs” on user profile
- Can export favorited events to calendar
- Counts shown on club pages
Subscriptions
- Purpose: Receive email updates from clubs
- Visibility: Club officers can see subscribers
- Data Shared: Name, email, school, major, graduation year
- Use Case: Get recruitment and event notifications
- Features:
- Club can send targeted emails
- Shows interest/engagement to club
- Can be used for application mailing lists
When to Use Each
- Favorite: Want to follow a club privately
- Subscribe: Want to receive emails and show interest to club
- Both: Most engaged members do both