GET /memberships
Verifies that the given membershipId exists in Club OS and you have access to it.
GET https://api.club-os.com/memberships?clubLocationId=[clubLocationId]&membershipId=[membershipId]
| 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 membership to the system. If the membership is added to a Club OS prospect account and the status is true, then the prospect will be converted to a member and some additional fields will apply (see below).
POST https://api.club-os.com/memberships?clubLocationId=[clubLocationId]
Request Body
The following fields must be included in the body of the HTTP request as a valid JSON string.
If the memberId is for a Club OS prospect and the agreement status is true,this is the Club OS unique id for the trainer who will be assigned to the prospect.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
| memberId | Integer | Y | The Club OS unique id for the member who bought the membership. | |
| salespersonId | Integer | Y | The Club OS unique id for the salesperson who sold the membership. | |
| localMembershipId | String | Y | Your systems unique id for the membership. | |
| status | Boolean | Y | false | 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 | The end date of the membership if one exists. | |
| saleDate | Date (M-d-YYYY) | Y | The date 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 | 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'. |
| trainerId | Integer | N | If the memberId is for a Club OS prospect and the agreement status is true, this is the Club OS unique id for the trainer who will be assigned to the prospect account. | |
| templateUsername | String | N | If the memberId is for a Club OS prospect and the agreement status is true, this is the username of a Club OS template to be applied to the prospect account. | |
| sendEmail | Boolean | N | false | If the memberId is for a Club OS prospect and the agreement status is true, this will send a welcome email to the prospect account. |
Response Messages
One of the following messages will be returned when the request succeeds.
| Message | Description |
| Membership Created | Membership successfully created. |
| Membership Updated | Membership successfully updated. |
PUT /memberships
Update a membership in the system. If the membership is added to a Club OS prospect account and the status is true, then the prospect will be converted to a member and some additional fields will apply (see below).
PUT https://api.club-os.com/memberships?clubLocationId=[clubLocationId]
Request Body
The following fields must be included in the body of the HTTP request as a valid JSON string.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
| membershipId | Integer | Y | The Club OS unique id for the membership to update. | |
| status | Boolean | Y | false | 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 | The end date of the membership if one exists. | |
| saleDate | Date (M-d-YYYY) | Y | The date 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 | 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'. |
| trainerId | Integer | N | If the memberId is for a Club OS prospect and the agreement status is true, this is the Club OS unique id for the trainer who will be assigned to the prospect account. | |
| templateUsername | String | N | If the memberId is for a Club OS prospect and the agreement status is true, this is the username of a Club OS template to be applied to the prospect account. | |
| sendEmail | Boolean | N | false | If the memberId is for a Club OS prospect and the agreement status is true, this will send a welcome email to the prospect account. |
Response Messages
One of the following messages will be returned when the request succeeds.
| Message | Description |
| Membership Created | Membership successfully created. |
| Membership Updated | Membership successfully updated. |