Skip to main content

Authorization

Follow this guide to create a new LearnUpon credential that will allow Nexla to authenticate to and exchange data with your LearnUpon account.
learnupon_api_auth.png

LearnUpon

Prerequisites​

LearnUpon uses HTTP Basic Authentication over HTTPS/TLS to secure API access. You will need a portal-specific API username and API key to authenticate — these credentials are separate from your LearnUpon admin login credentials.

LearnUpon Portal Requirements​

  • An active LearnUpon account with admin-level access to at least one portal.

  • API access must be enabled for your portal. If you are unsure whether API access has been activated on your account, contact LearnUpon support to request it.

Generate LearnUpon API Keys​

LearnUpon generates a single set of API credentials per portal. Each set consists of an API username and an API key, which together function as the username and password for HTTP Basic Authentication.

Important

A LearnUpon portal can have only one active set of API keys at a time. Generating a new set of keys will immediately invalidate any previously issued keys. Before generating new keys, verify that no existing integrations rely on the current API credentials.

To generate API keys for your LearnUpon portal:

  1. Sign in to your LearnUpon portal as an administrator.

  2. Navigate to Settings in the left-hand navigation menu.

  3. Select Integrations from the Settings submenu.

  4. Click API Keys within the Integrations section.

  5. Click the Generate New Keys button to create a new API username and API key for your portal.

  6. Copy and securely store both the API Username and the API Key that are displayed. These values will be required when configuring the Nexla credential.

The API Username and API Key are only shown in full immediately after generation. Store them in a secure location (such as a password manager) before navigating away from the page.

Create a LearnUpon Credential​

  • To create a new LearnUpon credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used to provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Credentials​

LearnUpon uses HTTP Basic Authentication. You will configure the API username and API key obtained from the LearnUpon portal settings above.

  1. Enter your LearnUpon portal subdomain in the Subdomain field (or the full base URL if prompted). Your subdomain is the portion of your LearnUpon portal URL before .learnupon.com — for example, if your portal URL is https://acme.learnupon.com, your subdomain is acme. Nexla will construct API requests to https://{subdomain}.learnupon.com/api/v1.

  2. Enter the API Username value obtained from your LearnUpon portal's Settings > Integrations > API Keys page in the API Username field. This is the API-specific username — not your admin login email.

  3. Enter the API Key value obtained from your LearnUpon portal in the API Key (or Password) field. This key acts as the password for HTTP Basic Authentication and authenticates Nexla's requests to the LearnUpon API.

For additional details about the LearnUpon API and authentication, refer to the official LearnUpon API documentation.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.