Account settings

This article outlines steps you can take if your organization is undergoing a domain change and you need to update the domain you currently have for your Udemy Business account. 

For example, if company EXAMPLE A is going to be changing to company EXAMPLE ABC, and so the Udemy Business domain needs to be changed from examplea.udemy.com to exampleabc.udemy.com.

Submitting a request to update your Udemy Business account domain

Although your account’s current domain is listed in the Customize appearance section of your Admin tools, admins are not able to change it on this page after it has been initially set up. Domain changes require assistance from Udemy.

Enterprise customers: If you’re an Enterprise Plan customer, please contact your customer success manager or Udemy contact directly to request a domain change. They will guide you through the necessary steps and coordinate with our internal teams to ensure a smooth transition. You can also contact Udemy Business Support.

Team Plan customers: If you’re a Team Plan customer, please contact Udemy Business Support for assistance with changing your account’s domain.

Important notes for customers with integrations

If your organization uses Udemy Business integrations, such as:

• Single Sign-On (SSO)
  
  
• Learning Management System (LMS)
  
  
• API access
  

Please make sure that the domain is updated in all relevant configuration URLs after the change. Failing to do so may result in login errors, course synchronization issues, or API failures.

The Settings section of your Udemy Business account is where you can customize the appearance of your account, enable access features, and configure integrations such as Single Sign-On (SSO). To access the Settings area click Manage > Settings.

What you can do in Settings:

• Customize the appearance of your account - logo, icon, background
• Use an approved email domain to give users ‘self-serve’ access
• Enable Single Sign-On (SSO) access from your Identity Provider 
• Use SCIM Provisioning to automate user and group management
• Access our courses and reporting APIs and documentation 
• Customize messaging and contacts for users who are denied access

Please note: While you may see your domain (i.e. company.udemy.com) in your account settings, you will not be able to change this on your end.

• If you have an Enterprise account, please reach out to your Customer Success partner to have your domain changed.
• If you have a Team Plan account, please reach out to our Support team for assistance. Make sure to provide the new domain you’d like for your organization.

To customize your account appearance, upload three images: a logo, a background image and your company icon. Go to Manage > Settings > Customize Appearance

1. Logo: upload a logo in one of the following formats: jpg, .jpeg, .gif, .png, .bmp. The logo should be at least 400 x 70 pixels.
2. Background image: upload a background image for your login page. It should be at least 1920 x 1080 pixels.
3. Icon: upload an optional square logo to use as a browser icon.  It should be at least 32x32 pixels.

This article explains how admins can set up Power BI to access the Udemy Business API and consume applicable data for reporting purposes. 

Please note that this guide specifically covers the process for connecting to and using the User-Course Activity API endpoint.

At this time, Udemy does not provide Power BI templates for other API endpoints. If you wish to connect to additional endpoints, you will need to create your own Power BI queries using the provided template as a reference.

• Review best practices for the Udemy Business API.
• Learn more about the Udemy Business API reference.

Setting up Power BI to access the Udemy Business API

1. Log in at your organization’s domain with admin privileges. For example, your organization URL should look similar to the following example: https://{your_domain}.udemy.com/organization/home/ .

2. Enable the API at the API integration page.
Go to Manage > Settings > APIs & Integrations > Select the API’s tab and select “Create Credentials”
(for example: https://{your_domain}.udemy.com/organization-manage-v2/settings/lms-integration/)

3. Copy the Client ID and Client Secret to a notepad from this screen and under documentation, click on the API documentation link. Then go to List user course activities on the left side bar (example: https://{your_domain}.udemy.com/developers/organization/reporting/methods/organizationusercourseactivity-list/get/).

4. Insert the client ID and client secret. This will generate the authorization token that you will use on Power BI.

5. Copy the authorization, open the file PowerBI_template and replace [insert-token] with authorization; Replace [insert-customer-domain] with yourdomain; Replace [insert-AccountID] with Organization_ID and save the file.

6. Open Power BI desktop.

7. Create a new DataSource Web, type in the home page for your organization (example: https://{your_domain}.udemy.com/), anonymous authentication.

Note: If you are getting the error “Access to resource is forbidden” with anonymous authentication, skip to step 8.

8. When it finishes connecting, click cancel and go to Get Data > Blank Query.

9. Click on Advanced Editor, select all information that you saved on PowerBI_template, and copy the template and paste it in the Advanced Editor then click Done.

10. Wait for the data to finish populating and you should now have all the data you need from the API endpoint.

• Note:  If you get an error message “the column "Column1" was not found", this indicates that there is no data.

This article outlines how Udemy Business admins can find their Rest API credentials for integrating Udemy with LMS, LXP, or other 3rd party systems.

Please note:

• APIs are only available to Enterprise customers.
• API settings can only be accessed by admins.
• This article does not apply for xAPI credentials. Learn more: Udemy Business xAPI.
• This article does not apply for GraphQL API credentials. Review how to enable the Udemy Business GraphQL.

How to enable and find your API credentials in Udemy Business

1 - Click on Manage in the upper right of Udemy Business.

2 - Click Settings  on the left-hand sidebar and then APIs & integrations.  Choose the system you will be integrating with from the drop-down menu, or Other, if your tool is not listed.  Click Save. Your API is now enabled.

3 - Your 4 Rest API Credentials will be available in the screen below.

Account Name / Subdomain
Account ID
Client ID
Client Secret

Note - xAPI credentials are used by some integrations for reporting insights sync in addition to the Rest API or GraphQL.  If your integration does not require xAPI you can leave this off.  Otherwise, please follow the instructions from your integration partner or review Udemy’s xAPI instructions for enabling this service.

With Udemy Business Web APIs (REST/GraphQL/xAPI), easily connect your admin tools, LMS platform, and HR suites with Udemy's catalog of courses (via metadata), and learner engagement data.

Empower workplace learning through:

• Automated user data syncing between Udemy Business and your employee directory (e.g., Okta, Azure)
• Embed search, discovery, and launch of Udemy Business courses and course lectures in your HR systems.
• Pull real-time course engagement analytics for your org straight from your apps

The Udemy Business Web APIs enable you to integrate world-class skills development from leading industry instructors into employees' daily flow of work. Upskill your workforce in top business, tech, and leadership competencies through Udemy's immersive video courses, curated learning paths, hands-on labs, assessments, and much more. Get started with a free trial of Udemy Business to experience the APIs firsthand. 

• To review the Udemy API License Agreement, please visit: https://www.udemy.com/terms/api/
  • Note: depending on how your company signed up for its Udemy Business account, you may be subject to additional or different terms, as listed in the agreement your company has signed.

Please Note: Access to Udemy Business APIs in this workspace requires an Enterprise Udemy Business subscription. If you're an existing customer, please contact Udemy Business Support if you need help with the APIs in this workspace. If you're not yet a Udemy Business customer, please contact sales@udemy.com.  If you wish to become a Technology Partner with Udemy, please submit a request to our Partnership team.

      Overview of available APIs

The Udemy Business Postman API workspace contains two types of Udemy Business APIs:

• REST - Integrate the Udemy Business course catalog and learner engagement data into your systems
• GraphQL - Search Course and Lecture metadata, and implement updates

xAPI

Udemy Business also offers an xAPI near real-time service. xAPI (or Experience API) is an e-learning data and specification interface standard to collect and share data about a learner’s experience, within the context of a wide range of learning activities. Udemy's xAPI service sends the following verbs corresponding to a learner’s progress and completion of a course:

1. Progress event
2. Completion event

These xAPI statements are POSTed to your xAPI-compatible system (e.g., LMS/LXP) in near real-time as the events occur in Udemy. Note that not all LMS or LxP systems support xAPI. Please check with those vendors for their support. For more information about Udemy Businesss xAPI, please visit our Help Center article. For setup, please review this Help Center resource. Key benefits of an xAPI-enabled integration can also be found in the preceding article.

Enabling your Udemy Business Client APIs: 
Only Udemy Business admins can enable the REST or GraphQL APIs.

1. As an admin, log in to your Udemy Business site.
2. For the REST APIs, navigate to Manage/Settings/LMS/LXP Integrations (it's more than just LMS or LXP integrations, but these systems tend to be common integration points for Udemy)
   1. Enable the Integration; you can choose "Custom Integration" to set up a generic name.
   2. Use the Client ID and Client Secret in your API Client (or this Postman Collection - be sure to copy the Postman Collection to your Private Workspace)
3. For the GraphQL APIs, navigate to https://ACCOUNT_NAME.udemy.com/dev-portal/api-clients/, where ACCOUNT_NAME is your unique subdomain and Udemy Business vanity URL.
4. From the API Client page, activate your GraphQL API.

Top use cases

Whether you use an LMS, HCM platform, or custom admin portal, you can leverage Udemy Business APIs for various use cases. The following use cases are the most common:

Discover and launch courses

• Search and browse through thousands of Udemy Business courses from within your internal system (e.g., Learning Management System, or Learning Experience Platform)
• Enable single sign-on (SSO) to seamlessly access your Udemy Business site when launching Udemy Business Courses (or Course Lectures) from your internal system
• Track learner course assignments, progress, and completion in your internal system

Reporting and analytics

• Import comprehensive engagement data
• Analyze course enrollments, progress, and performance
• Map learning to skills for development initiatives
• Align with broader L&D strategy and goals

Skills gap analysis

• Match employee skills gaps to relevant Udemy Business courses, or course lectures
• Personalize suggested Courses, or Course Lectures, to address skills gaps
• Onboard more efficiently with targeted recommendations

Work alongside our solutions engineering team for a tailored integration experience. Contact Udemy Business to explore partnership opportunities.

 Best practices

Optimize Udemy Business API integration

Enable seamless learner access with SSO:

• Configure SAML 2.0 or SCIM for your Udemy Business Application with your Identify System, to enable frictionless user login and course access
• Automate account creation and updates
• Centralize access to your Udemy Business enterprise learning platform

GraphQL is preferred for course data:

• Incremental updates for optimal syncing vs. bulk loads
• Avoid repetitive calls with built-in caching
• Use semantic Search for optimal course and course lecture matching

Filter, sort, paginate:

• Utilize query parameters to retrieve only relevant data
• Control result sets for performance

Evaluate complexity to prevent over-fetching:

• Analyze API call volume and frequency
• Implement rate limiting to prevent abuse
• Load test to validate scalability

Following API best practices ensures performant, sustainable integrations between Udemy Business and your core HR or other third-party systems. The Udemy Business Sales & Solutions Engineers can advise on an integration strategy tailored to your use cases and infrastructure.

Help and support

If you have any questions, please contact our Customer Support team or our Partner Support team.

This article outlines how admins for Team Plan accounts can update the payment method on file or remove a saved payment card. 

How to update the payment method on file

Admins of Team Plan accounts can update the payment method on file for their accounts by taking the following steps:

1. Log into your Udemy Business account
2. Navigate to Manage > Settings > Billing
3. Click on Add payment method
4. Input your card details
5. Click Save Card

This article outlines how account owners can approve the migration of learning data, when a request to merge Udemy Business sites related to their company has been submitted.

• Learn more about merging multiple Udemy Business sites.

Please note: Once both account owners approve the migration, the source site will go into maintenance mode and users will be unable to access Udemy for Business. Please be sure to review the section below regarding the maintenance mode.

Table of Contents

• Beginning the data migration process
• Source site approval process
• Destination site approval process
• Important information regarding maintenance mode following approval
• Important note regarding SSO and SCIM integrations

Beginning the data migration process

Once your Customer Success partner has started the migration process, the account owners of both sites (the source and destination Udemy Business sites) will each receive an email to approve the migration. 

Source site approval process

If you are the account owner of the source site: 

1. Click on Start Approval Process. Then, follow the instructions to log in to your Udemy Business account. 

Please note: If you are logging in with single sign-on (SSO) and being redirected to the homepage, please click on the Start Approval Button again to continue.

2. Enter the Destination URL (where you would like data to be migrated to) and then click Proceed. 

Please be sure to enter the correct URL. Otherwise, you will receive an error message and will not be able to move forward.

3. Review the information, check the box and click Approve to agree to migrate the data. 

4. You will receive a confirmation pop-up to advise that the migration is in progress. 

Destination site approval process

If you are the account owner of the destination site:

1. Click on Start Approval Process. Then, follow the instructions to log in to your Udemy Business account. 

Please note: If you are logging in with single sign-on (SSO) and being redirected to the homepage, please click on the Start Approval Button again to continue.

2. Enter the Source URL (where you would like data to be migrated from) and then click Proceed. 

Please be sure to enter the correct URL. Otherwise, you will receive an error message and will not be able to move forward.

3. Review the information, check the box, and click Approve to agree to migrate the data.

4. You will receive a confirmation pop-up to advise that the migration is in progress.

Important information regarding maintenance mode following approval

Once both account owners approve the migration, the source site will go into maintenance mode, which means it will not be possible for users to access that Udemy for Business site. All integrations such as SSO, SCIM, or LMS will also be disabled in the source site in order to preserve the data to be migrated.

Important note regarding SSO and SCIM integrations

As part of the migration process, SSO and SCIM integrations will be disabled on the source site. Once the migration process is complete, admins will need to grant access to the migrated users within their Identity Providers for SSO and SCIM. 

• Learn more about Udemy Business SSO and its core features.
• Review how to automate user and group management with SCIM.

This article outlines the initial steps to request more information if you are interested in merging two or more Udemy Business sites. 

For example, if your company has two Udemy Business sites (such as a regional site uk-company.udemy.com, and a global site company.udemy.com), you can request to have them merged. This means users and their learning history will be moved from one site to a single domain. 

Udemy Business supports merging Enterprise Plan or Team Plan sites into Enterprise Plan sites. In other words, we do not support merging two Team Plan sites or merging an Enterprise Plan site into a Team Plan site. 

Table of contents 

• Reasons to combine multiple Udemy Business sites
• How to request more information about migrating Udemy Business sites  

Reasons to combine multiple Udemy Business sites 

Some of the reasons you might want to merge Udemy Business sites are listed below: 

Your company has multiple Udemy Business accounts, contracts, and sites that you’d like to merge into one 

• You’d like to make it easy for your learners to access Udemy Business on one site.
• You want a centralized view of your learner insights for the entire company.
• Your company may be undergoing a merger or acquisition, and both sites need to be consolidated. 

How to request more information about migrating Udemy Business sites 

1. Contact your Customer Success partner to discuss your merge requirements and determine if you qualify for the free merge process or require paid services. 

2. When contacting us, please advise: 

• Source URL of the site you wish to move the data from.
• Destination URL of the site you would like to migrate the data into.
• If the source or destination site utilizes SSO, SCIM, LMS/LXP, or other integrations.
• If you have public learning paths or custom categories in the source site, which you want replicated in the destination site.
  • Note: Private paths can’t be replicated across sites.
• If there are duplicate users across both the source & destination sites.
  • Note: Duplicate users can’t be moved as part of a site merge.
• If there are email domain reformatting requirements.

3. Your Customer Success partner will submit an internal request to verify the commercial feasibility for a site merge. 

4. They will be in touch to provide an update regarding feasibility once the Udemy team has reviewed the request. 

5. If a site merge is feasible, they will provide the next steps in the process to further scope the site merge.