Gradual’s Credly integration allows you to automatically award Credly badges when a member completes a mapped course or learning path in your community.
This integration is useful for communities that use Gradual to deliver learning experiences and Credly to manage digital credentials.
Set up the Credly integration
To connect Credly to Gradual:
Go to Integrations in your admin dashboard.
Find Credly and click Set Up.
In the Credly configuration window, enter:
Organization ID
Client ID
Client Secret
Click Connect.
Gradual verifies your credentials before saving the connection. If the details entered are incorrect, you will see the following message: Unable to connect to Credly. Please check your Organization ID and OAuth credentials.
Once the connection is successful, the badge mapping and error log sections will appear.
Map Gradual courses to Credly badge templates
After Credly is connected, Gradual syncs your active badge templates from Credly so you can map them to courses and learning paths.
To create a mapping:
In the Gradual Courses → Credly Badges section, select a course or learning path from the first dropdown.
Select a Credly badge template from the second dropdown.
Click Add a mapping to create additional mappings.
Click the remove icon on any row to delete that mapping.
Each course or learning path can be mapped to one badge template.
Automatically issue badges when a course is completed
When a member reaches Complete status for a mapped course or learning path, Gradual automatically sends the completion information to Credly and requests badge issuance.
The badge request includes the member’s:
email address
first name
last name
Each member can receive one badge per mapped course or learning path. If the first badge request does not go through, Gradual automatically retries once.
Gradual’s existing course completion flow already tracks when a learner finishes all required content, and this integration uses that completion status to trigger badge issuance.
Review integration errors
The Credly configuration window includes an Error Log section so you can review connection or badge issuance issues.
The log includes:
Timestamp
Error
Details
You may see messages such as:
Connection expired
Your Credly OAuth credentials have expired or were revoked. Please reconnect.Badge issuance failed
Failed to issue badge “{badge name}” to “{email}”. {error}API Rate Limit
Hit Credly API rate limit; badge issuance paused. [Error]
Use the error log to identify why a badge was not issued and what needs to be updated.
Remove the Credly integration
To remove the integration:
Go to Integrations.
Find Credly and click Remove.
Confirm the removal in the pop-up window.
You will see this message: Are you sure you want to remove this integration? The configuration will be cleared and it is irreversible.
Removing the integration deletes:
saved Credly credentials
all course-to-badge mappings
error log history
Best practices
Before rolling this out broadly, it is a good idea to map and test one course first to confirm that badges are being issued as expected.
It is also important to make sure member profile information is accurate, especially first name, last name, and email address, since Credly uses this information when issuing badges.