Overview: This article explains the two ways your employees can earn Motivosity rewards for completing Sworkit activities — and exactly what your team needs to do for each. Understanding the difference between these two paths before getting started will save time and prevent confusion.
The Two Paths at a Glance
| Path 1: Activity-Based Achievements | Path 2: Sworkit Challenge with Leaderboard |
What it is | Employees earn Motivosity rewards for completing everyday Sworkit activities (workouts, steps, minutes, etc.) | A structured competition inside Sworkit with a visible leaderboard, tied to a Motivosity achievement |
Built in Sworkit? | ❌ No — nothing to build in Sworkit | ✅ Yes — the challenge must be created in the Sworkit platform |
Built in Motivosity? | ✅ Yes — create the achievement in MV | ✅ Yes — create a matching achievement in MV |
Webhook required? | ✅ Yes — send webhook details to Sworkit | ✅ Yes — send webhook details to Sworkit |
Not sure which path you need? If you just want to reward employees for their ongoing Sworkit activity (workouts, steps, etc.), use Path 1. If you want a company-wide competition with a leaderboard and a reward, use Path 2.
Path 1: Activity-Based Achievements
Use this path to reward employees for completing everyday Sworkit activities like logging workouts, reaching step goals, or completing meditation sessions.
You do not need to build anything inside the Sworkit platform. Sworkit handles activity tracking on the backend — your only job is to set up the achievement in Motivosity and send Sworkit the webhook.
Steps
Step 1 — Decide What to Reward
Choose which Sworkit activities you want to reward and at what thresholds. The table below shows recommended starting points:
Activity | Recommended Frequency | Suggested Goal |
Register for Sworkit | One-time | — |
Complete Minutes of Activity | Weekly | 150 minutes |
Complete Workouts | Monthly | 3 workouts |
Complete Steps | Monthly | 150,000 steps |
Read Nutrition Articles | Quarterly | 5 articles |
Complete Meditations | Quarterly | 5 sessions |
Complete a Fitness Assessment | Quarterly | 1 assessment |
Milestone – Steps | Annually | 1,000,000 steps |
Milestone – Minutes | Annually | 5,000 minutes |
You can customize thresholds to match your company's goals. These are recommendations, not requirements.
Step 2 — Create the Achievement in Motivosity
In the Motivosity platform, use the "Create a SWORKIT Achievement" flow to set up each achievement. This is a dedicated achievement type built specifically for the Sworkit integration — look for it when creating a new achievement.
📸 [Insert screenshot: Create a SWORKIT Achievement — shows the multi-step flow in Motivosity with fields for icon, name, description, frequency, limits, visibility, and the Copy Webhook button at the end]
For each achievement, you'll configure:
Icon — choose from the Sworkit icon set or upload a custom one
Name — make it clear and employee-facing (e.g., "Complete 400 Minutes of Exercise Per Month")
Description — explain how an employee earns it
Frequency — match this to your chosen schedule (weekly, monthly, quarterly, one-time, etc.)
Limits — optionally restrict by country, user group, or department
Visibility — set whether the award posts publicly to the home feed
Once you click Create, you'll reach a confirmation screen with a "Copy Webhook" button. Copy this webhook URL — you'll need it in the next step.
Step 3 — Send Webhook Details to Sworkit
Once each achievement is created, email the following to your Sworkit and MV contacts. Sworkit cannot connect the reward without all of these details:
Metric and threshold (e.g., "150 minutes of activity")
Frequency (weekly, monthly, quarterly, annually, or one-time)
Award amount
Start date
End date
Webhook URL (copied from the MV achievement confirmation screen)
Step 4 — Confirm and Go Live
Sworkit will confirm when the webhook is configured and active. Before announcing to employees, both teams should verify that a test trigger fires correctly end-to-end.
Path 2: Sworkit Challenge with Leaderboard
Use this path when you want to run a structured, time-bound competition — with a leaderboard visible to participants inside the Sworkit app — and reward participants through Motivosity when they hit the goal.
This path requires setup in both Sworkit and Motivosity. You cannot skip the Sworkit build step.
Steps
Step 1 — Plan and Build the Challenge in the Sworkit Admin Portal
The client admin creates the challenge directly in the Sworkit Admin Portal. Your Sworkit CS representative will walk you through the process and review your setup before launch — but the build happens in your account.
Start by exploring your options. Inside the Admin Portal, head to the Challenges section to browse ready-made templates and popular challenge ideas. You can also customize from scratch. Challenges can be run as individual, team, or group competitions, and can be built around any of the following metrics:
Metric | What It Tracks | Example Goal |
Active Minutes | Minutes of logged activity | 150 minutes/week |
Active Days | Days with any logged activity | 5 active days/week |
Challenge Workouts | Pre-selected Sworkit app workouts | Complete all low-impact workouts at own pace |
Steps | Daily step count | 5,000 steps/day |
Distance | Distance traveled | 1 marathon/month |
Want inspiration? Check out these resources before you build:
How do I create a challenge for my company? — step-by-step visual guide in the Admin Portal
Challenge Ideas and Engagement Tips to Inspire your Company — popular formats and what works
Help Guide for Challenge Participants — share with employees so they know how to join and track progress
Heads up on data syncing: Employees can connect their phone's health app (Apple Health or Google Fit) or a wearable device to log steps, minutes, and distance to Sworkit automatically. Share the relevant help articles with participants before the challenge starts so their data counts from day one.
Once you've built your challenge, confirm the following details — you'll need them for both the Motivosity achievement (Step 2) and the webhook (Step 3):
Challenge name and description
Start and end dates
Goal metric and threshold
Challenge type (individual, team, or group)
Participant eligibility (all employees, specific groups, etc.)
Step 2 — Create a Matching Achievement in Motivosity
In the Motivosity platform, use the "Create a SWORKIT Achievement" flow — the same dedicated flow used for activity-based achievements — to create an achievement that maps directly to this challenge.
The achievement should reflect the challenge goal. For example: "Reached the company step challenge goal." Set the Frequency to one-time, since this fires when a participant hits the challenge threshold.
Make sure the metric and threshold in the achievement description match exactly what you configured in the Sworkit challenge — employees will see both, and they need to align.
Once you click Create, copy the webhook URL from the confirmation screen. You'll need it in the next step.
📌 Motivosity CS Team: Guide the client admin through the SWORKIT Achievement flow for this challenge. Double-check that the goal, metric, and dates match what Sworkit has configured. Remind them to copy the webhook URL before closing the confirmation screen.
Step 3 — Send Webhook Details to Sworkit
Once the Motivosity achievement is created, send the following to both your Sworkit and Motivosity contacts.
Metric and threshold (must match exactly what was set up in the Sworkit challenge)
Frequency (one-time)
Award amount
Challenge start date
Challenge end date
Webhook URL (copied from the MV achievement confirmation screen)
Step 4 — Sworkit Connects the Webhook
Sworkit links the Motivosity webhook to the challenge in the Sworkit Rewards API. When a participant reaches the challenge goal, the webhook fires automatically, triggering the Motivosity achievement award.
Step 5 — Test and Go Live
Both teams confirm the full connection is working — challenge visible in Sworkit, webhook firing correctly, and achievement awarding in Motivosity — before the challenge is announced to employees.
Common Questions
Do I need to build anything in Sworkit for activity-based achievements? No. For Path 1, there is nothing to build in the Sworkit platform. Sworkit tracks activity automatically once the webhook is connected. Just create the achievement in Motivosity and send us the webhook details.
Can I run both paths at the same time? Yes. Many companies use activity-based achievements year-round and layer in challenge-based achievements for seasonal campaigns or special initiatives.
What if I want a leaderboard challenge but no Motivosity reward? You can create a Sworkit challenge with a leaderboard without connecting a Motivosity achievement — simply skip the Motivosity steps. Contact your Sworkit CS rep to set up the challenge.
What if I'm not sure which path is right for us? Reach out to your Sworkit CS contact or your Motivosity CS contact. We're happy to walk through the options together.
Who to Contact
Need | Contact |
Sworkit challenge setup, activity tracking, or webhook issues | Your Sworkit CS contact |
Motivosity achievement setup | Your Motivosity CS contact |
