Skip to main content

Sworkit Health Activities for Motivosity Achievement Setup

How to Choose and Set Up Sworkit Activities and/or Challenges for Motivosity Achievements

Written by Victoria
Updated today

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:

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


Did this answer your question?