Special Black Friday Offer: Lifetime pricing plan + Unlimited everything + Onetime payment

Lifetime pricing plan + Unlimited everything + Onetime payment

Fresh LMS API Reference

The FreshLMS API is base around REST. We return JSON for every request.

This is unique API key which you will use in the API’s .


Authentication

To start using the FreshLMS API, You have to login to your Admin account and goto Settings -> User and click on your user. You will find the API Key.

API Methods

FreshLMS API lets you send the information about member and course enrollment related details seamlessly.

Create Member

POST/integration/member

Adds a New Member

https://api.freshlms.com/v1/integration/member

Header Parameters:

KeyValue
api-keyThis is the request header parameter, unique key assigned in your admin settings.

Request Parameters:

In each POST Request body following parameters need to be sent in JSON

emailMandatory, Member’s email address
fullNameMandatory, Member’s full name
phoneMember’s Phone Number
cityMember’s city of residence
sourceMandatory, Zapier/Fresh LMS/etc
cURL example

curl -X POST \
https://api.freshlms.com/v1/integration/member \
-H 'api-key: ffec555c3fc0a0882f2720weewew' \
-H 'content-type: application/json' \
-d '{{'{'} "email": "john@gmail.com","fullName": "John Sculley",
"phone": "0113452310", "city": "Seattle", "source": "Zapier’

Example Request


"email": "john@gmail.com",
"fullName": "John Sculley",
"phone": "0113452310",
"city": "Seattle",
"source": "Zapier"

Example Response: 201 Created


"id": 39744,
"fullName": "John Sculley",
"email": "john@gmail.com",
"phone": "0113452310",
"city": "Seattle",
"source": "Zapier",
"message": "Memebr created successfully ",
"createdDate": "2021-04-27"

Update Member

PUT/integration/member/update

Update member information based on registered email

https://api.freshlms.com/v1/integration/member/update

Header Parameters:

KeyValue
api-keyThis is the request header parameter, unique key assigned in your admin settings.

Request Parameters:

In each PUT Request body following parameters need to be sent in JSON

emailMandatory, Member’s email address, (email can not be modified)
fullNameMandatory, Member’s full name
phoneMember’s Phone Number
cityMember’s city of residence
sourceMandatory, Zapier/Fresh LMS/etc
cURL example

curl -X PUT \
https://api.freshlms.com/v1/integration/member/update \
-H 'api-key: ffec555c3fc0a0882f2720weewew' \
-H 'content-type: application/json' \

"phone": "0113452310", "city": "Seattle", "source": "Zapier’

Example Request


"email": "john@gmail.com",
"fullName": "John Sculley",
"phone": "0113452310",
"city": "Seattle",
"source": "Zapier"

Example Response: 200 OK


"id": 39744,
"fullName": "John Sculley",
"email": "john@gmail.com",
"phone": "0113452310",
"city": "Seattle",
"source": "Zapier",
"message": "Memebr created successfully ",
"createdDate": "2021-04-27"

Enroll Member

POST/integration/member/enroll

Update member information based on registered email

https://api.freshlms.com/v1/integration/member/enroll

Parameters:

KeyValue
api-keyThis is the request header parameter, unique key assigned in your admin settings.

Request Parameters:

In each POST Request body following parameters need to be sent in JSON

courseIdMandatory, Course unique identifier from Admin Portal.You will find this under the course name. See here
planIdMandatory, You will find this against the course -> pricing.
memberEmailMandatory, Member’s Email Address,
paymentGatewayManual/Stripe/Paypal/etc
paymentTypecash/cheque/etc
referenceReferences if any for enrollment
transactionDatePayment transaction date in ‘yyyy-MM-dd’ format
transactionIdMandatory, Payment unique identifier for the enrollment
sourceMandatory, Zapier/Fresh LMS/etc
cURL example

curl -X POST \
https://api.freshlms.com/v1/integration/member/enroll \
-H 'api-key: ffec555c3fc0a0882f2720weewew' \
-H 'content-type: application/json' \

"john@gmail.com","paymentGateway": "stripe",
"paymentType": "cheque", "reference": "Course Enrollment Fee",
"transactionDate": "2021-01-01","transactionId": "abc_1123345",
"source": "zapier"

Example Request


"courseId": 39555,
"planId": 40234,
"memberEmail": "john@gmail.com",
"paymentGateway": "stripe",
"paymentType": "cheque",
"reference": "Course Enrollment Fee",
"transactionDate": "2021-01-01",
"transactionId": "abc_1123345",
"source": "zapier"

Example Response: 200 OK


"enrollmentId": 39745,
"courseId": 39555,
"memberEmail": "john@gmail.com",
"planId": 40234,
"transactionId": "abc_1123345",
"transactionDate": "2021-01-01",
"paymentType": null,
"paymentGateway": null,
"reference": "Course Enrollment Fee",
"source": "zapier",
"createdDate": "2021-04-27"

API Errors

Fresh lms API integration uses HTTP status to indicate the status of the request, Here is the possible response codes

200 OK Success response
201 CREATED when new requested item is created
400 Bad Request you did not provide Mandatory, parameter or wrong data
401 Unauthorized you did not provide a valid api key