disabled
Back To Udemy

Sign in
English (US) Deutsch Español Français (France) Italiano Polski Português Türkçe
  • Sign in
  • English (US) Deutsch Español Français (France) Italiano Polski Português Türkçe
Search for solutions
Student Topics
Instructor Topics
Udemy Business Topics
Read article
Combined Results
Do these help?
What's this?
Udemy Business
  1. Udemy
  2. APIs & Integrations
  3. Documentation & Support Guides

Recommended Integration Steps for Technology Partners

A quick-start guide for your integration

We want your integration to go live quickly, so we can both open up new markets for our mutual-customers. 

Udemy Business Integrations Page, pictured below

partner with us.png

Prerequisite steps

  • Partnership application submitted and approved
  • Udemy provisions sandbox environment for Udemy Business
  • Udemy admin invites additional users

If any of these items are missing, please refer to the (Getting Started Guide) to complete them first

Partner integration use cases: If you would like to review the high level use-cases that these integration steps support.  If not, let's move into development.

Development steps

Our recommended best practice is to mitigate technical risk, by connecting to all Udemy APIs first, and then begin software development after all endpoints are confirmed working.

  • Connect to Courses API, return at least 10 courses
  • Connect to Course API, return 1 course
  • Log into your Udemy Business site and enroll in a course, watch a lecture for at least 1 minute (you can increase the speed of playback)
  • Connect to Reporting API (user-activity)
  • Connect to Reporting API (user-course-activity)
  • Connect to Reporting API (learning-activity-attempt)

Configurations

With the majority of the APIs all working, you can move to configuration steps.

  • Single Sign On (SSO) configuration is done directly inside the your Udemy Business Settings page.  You will need to have administrator credentials to access these settings.  Setup out-of-the-box SSO with one of our many providers.  Or create a custom connection with SAML 2.0.  (link to SSO documentation)
  • Go through the rest of the settings within the [Udemy Business: Manage: Settings] and customize to your liking

Enhancements

Learning Paths - Allows users to create a curriculum containing a large variety of learning resources, with a start and end to guide the learner.

  • Log into your Udemy Business site and create a Learning Path (documentation), open a course and add that course to the learning path you just created
  • Connect to the Learning Path API; return the learning path you created
  • Connect to Reporting API (learning-path-activity)

Real-time reporting via Webhook

  • Setup xAPI - Udemy’s webhook for reporting data of the learner’s progress and completion events (documentation).  You will add parameters into the Udemy admin settings page.
  • Once setup, watch a short lecture at maximum playback speed and see if you received the progress data.

Query or search course data - Using Udemy’s GraphQL API, we allow queries to our course catalog, returning only the data you need for that specific use case.  Additionally, we also provide a Search API that takes your input and filters and returns relevant course results.

  • Obtain GraphQL API credentials
  • Call GraphQL function GetAuthToken()
  • Use the [authToken] to call the Courses API
  • Call the CourseSearch API

Note: A Udemy Business login is required to access GraphQL Documentation. The applicable URL features the subdomain for your organization's Udemy account followed by .udemy.com/dev-portal/api-reference/. 

For example:

https://{your_subdomain}.udemy.com/dev-portal/api-reference/.

Core software development

With all of the Udemy credentials working, all APIs connected to, and additional configurations setup, the technical risk has been removed.  Most partners will next move to planning or head right into development.  One way to get started is to take a list of user stories or supported use-cases and map the Udemy APIs needed for each use-case.  Best of luck to your software engineering from here!  

Error handling, exceptions, and best practices

Harden your software by incorporating error handling, exceptions, and edge-cases.  To handle unexpected IT issues, we have a variety of error-handling recommendations.  

  • Log error responses returned by APIs
  • Add retry logic to API calls
  • Handle rate limits by using page_size best practices
  • Implement other best practices contained in the document

For additional support, feedback, or upon completion of your new integration, please contact us at partnersupport@udemy.com.  We are looking forward to opening new markets together with our new mutual functionality.

Updated August 29, 2024 11:24
Was this article helpful?
0 out of 0 found this helpful

Related articles

  • Partner Integration Use Cases
  • What are the Requirements to Join the Udemy Affiliate Program?
  • Summary of Available APIs
  • How do I Join the Udemy Affiliate Program?
  • How to Apply
Contact Us

Related articles

  • Partner Integration Use Cases
  • What are the Requirements to Join the Udemy Affiliate Program?
  • Summary of Available APIs
  • How do I Join the Udemy Affiliate Program?
  • How to Apply
Contact Us
'title:Integration Steps for Technology Partners','featured_partner',
English (US) Deutsch Español Français (France) Italiano Polski Português Türkçe
  • Udemy Business
  • Teach on Udemy
  • Get the app
  • About us
  • Contact us
  • Careers
  • Blog
  • Affiliate
  • Investors
  • Terms
  • Privacy policy
  • Cookie settings
  • Sitemap
  • Accessibility statement
Udemy
© 2025 Udemy, Inc.