GET /memberships
Verifies that the given membershipId exists in Club OS and you have access to it.
GET httphttps://api.club-os.com/memberships?clubLocationId=[clubLocationId]&membershipId=[membershipId]
Parameters
The following fields must be included as parameters in the URL of the request.
| Variable | Type | Description |
|---|---|---|
| clubLocationId | Integer | The Club OS unique id for the club location you wish to access. Club OS will provide these to you. |
| membershipId | Integer | The Club OS unique id for the membership you are requesting. |
POST /memberships
Add a user membership to the system.
POST httphttps://api.club-os.com/memberships?clubLocationId=[clubLocationId]
...
Parameters
The following fields must be included as parameters in the body URL of the HTTP request.
| PropertyVariable | Type | Required | DefaultDescription | |
|---|---|---|---|---|
| roleclubLocationId | String | Y | One of 'member', 'trainer', 'salesperson'. | |
| fullAccount | Boolean | Y | false | Club OS has 2 types of member accounts, Full and Basic. Full means they get access to both nutrition and/or workout features based on the club's service plan. false - Make the member a Basic account. true - Make the member full account. |
| trainerId | Integer | NInteger | The Club OS unique id for the club location you wish to access. Club OS will provide these to you. |
Request Body
The following fields must be included in the body of the HTTP request as a valid JSON string.
Note: If the membership being added belongs to a Club OS lead account and the status is true, then the lead will be converted to a member on a successful request.
...
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
| memberId | Integer | Y | The Club OS unique id for the trainer of the user being added or updatedmember who bought the membership. | |
| salespersonId | Integer | N | The Club OS unique id for the salesperson of the user being added or updated (applies to members only). | |
| templateUsername | String | N | The username of the template account that should be applied to the user (applies to members only). | |
| localUserIdwho sold the membership. If null, the default sales support account will be used. | ||||
| localMembershipId | String | Y | Your systems unique id for the usermembership. | |
| firstNamestatus | StringBoolean | Y | User first name. | |
| lastName | String | N | User last name. | |
| String | Y | Email address of the user. | ||
| gender | String | Y | 'M' for male, 'F' for female. | |
| birthdatefalse | true - the membership is active and the customer is caught up on payments. false - the membership is inactive due to deliquent billing, membership cancellation, etc. | |||
| autoRenew | Boolean | Y | false | true - membership auto-renews. false - membership does not auto-renew. |
| startDate | Date (M-d-YYYY) | Y | The effective start date of the membership. | |
| endDate | Date (M-d-YYYY) | N | User The end date of birththe membership if one exists. | |
| joinDatesaleDate | Date (M-d-YYYY) | NY | The date the User joined the club. | |
| homePhone | String | N | User home phone number. | |
| workPhone | String | N | User work phone number. | |
| mobilePhone | String | N | User mobile phone number. | |
| address1 | String | N | User address line 1. | |
| address2 | String | N | User address line 2. | |
| city | String | N | User full city. | |
| state | String | N | User 2 letter state code, i.e. PA for Pennsylvania. | |
| zip | String | N | User zip code. |
PUT /users
Update a users account type
| of the sale. | ||||
| name | String | Y | The name of the membership, i.e. 'Gold', 'Silver', 'Platinum' | |
| paidOnSale | Decimal | Y | The amount paid on the saleDate, or the date the membership was purchased. | |
| downPaymentName | String | C | The name of the down payment, i.e. 'Initiation Fee', or 'First Month Fee'. Required if the downPaymentSubtotal is included in the request. | |
| downPaymentSubtotal | Decimal | C | The amount of the down payment without taxes. Required if no recurPaymentSubtotal. | |
| downPaymentTaxes | Decimal | N | The amount of taxes on the down payment. | |
| recurPaymentName | String | C | The name of the recurring payment, i.e. 'Membership Dues'. Required if recurPaymentSubtotal is included in the request. | |
| recurPaymentSubtotal | Decimal | C | The amount of the recurring payment without taxes. Required if no downPaymentSubtotal. | |
| recurPaymentTaxes | Decimal | N | The amount of taxes on the recurring payment. | |
| recurType | String | N | monthly | One of 'monthly' or 'weekly'. |
| trainerId | Integer | N | If the memberId is for a Club OS lead and the membership status is true, this is the Club OS unique id for the trainer who will be assigned to the lead account. | |
| templateUsername | String | N | If the memberId is for a Club OS lead and the membership status is true, this is the username of a Club OS template to be applied to the lead account. | |
| sendEmail | Boolean | N | false | If the memberId is for a Club OS lead and the membership status is true, this will send a welcome email to the lead account. |
| username | String | N | The username of the new account (if lead converted). Default is to use email. | |
| password | String | N | The password of the new account (if lead converted). Default will be auto-generated. |
Response Messages
One of the following messages will be returned when the request succeeds.
| Message | Description |
| membership created | Membership successfully created. |
| membership created and lead converted | Membership successfully updated and lead converted to member. |
| membership exists | Membership exists already, use PUT method instead. |
PUT /memberships
Update a membership in the system.
PUT https://api.club-os.com/usersmemberships?clubLocationId=[clubLocationId]
...
Parameters
The following fields must be included as parameters in the URL of the request.
| Variable | Type | Description |
|---|---|---|
| clubLocationId | Integer | The Club OS unique id for the club location you wish to access. Club OS will provide these to you. |
Request Body
Any of the fields below may be included in the body of the HTTP request as a valid JSON string. Only fields included in the request will be updated. For example, if you only wanted to change the status of the membership, the JSON should be { membershipId: "clubOsMembershipId", status: "false"}.
| Property | Type | Required | Default | Description | |||||
|---|---|---|---|---|---|---|---|---|---|
| userIdmembershipId | Integer | Y | The Club OS unique id for the member to update | fullAccount | Boolean | Y | false | Club OS has 2 types of member accounts, Full and Basic. Full means they get access to both nutrition and/or workout features based on the club's service plan. false - Make the member a Basic account. true - Make the member full accountmembership to update. | |
| salespersonId | Integer | N | The Club OS unique id for the salesperson who sold the membership. | ||||||
| status | Boolean | N | true - the membership is active and the customer is caught up on payments. false - the membership is inactive due to deliquent billing, membership cancellation, etc. | ||||||
| autoRenew | Boolean | N | true - membership auto-renews. false - membership does not auto-renew. | ||||||
| startDate | Date (M-d-YYYY) | N | The effective start date of the membership. | ||||||
| endDate | Date (M-d-YYYY) | N | The end date of the membership if one exists. | ||||||
| saleDate | Date (M-d-YYYY) | N | The date of the sale. | ||||||
| name | String | N | The name of the membership, i.e. 'Gold', 'Silver', 'Platinum' | ||||||
| paidOnSale | Decimal | N | The amount paid on the saleDate, or the date the membership was purchased. | ||||||
| downPaymentName | String | N | The name of the down payment, i.e. 'Initiation Fee', or 'First Month Fee' | ||||||
| downPaymentSubtotal | Decimal | N | The amount of the down payment without taxes. | ||||||
| downPaymentTaxes | Decimal | N | The amount of taxes on the down payment. | ||||||
| recurPaymentName | String | N | The name of the recurring payment, i.e. 'Membership Dues'. | ||||||
| recurPaymentSubtotal | Decimal | N | The amount of the recurring payment without taxes. | ||||||
| recurPaymentTaxes | Decimal | N | The amount of taxes on the recurring payment. | ||||||
| recurType | String | N | monthly | One of 'monthly' or 'weekly'. |
Response Messages
One of the following messages will be returned when the request succeeds.
| Message | Description |
| membership updated | Membership successfully updated. |
| membership not found | Membership could not be found based on the given membershipId. |