SCIM Provisioning Guide for Wellness Coach

SCIM Configuration Guide

Wellness Coach’s System for Cross-domain Identity Management (SCIM) integration allows you to use data from your SCIM identity provider (IdP) to manage users within Wellness Coach. With this integration, your users will be automatically added, changed, and archived in Wellness Coach based on data sent from your SCIM IdP. Once you configure this integration and import your users, you’ll be able to manage all your users in one place.

A SCIM “User” is represented through:

• Core Schema
  urn:ietf:params:scim:schemas:core:2.0:User

• Enterprise User Schema Extension
  urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

• (Optional) Custom Enterprise Extension
  Wellness Coach requires that all custom attributes also use the enterprise extension namespace for consistency.

Wellness Coach platform supports:

• User creation

• User updates

• User deactivation

• Custom attribute ingestion

• Enterprise SCIM extension support

---

Prerequisites

Before you configure SCIM, make sure that you meet the following requirements:

• You must have completed SSO integration with Wellness Coach for the IdP you use. See the article below:

  • How to Configure SSO for IdP

• You have access to your SCIM Token and Tenant URL in your Account Settings. For more information about where you can find these items, see the Configure SCIM section below.

• You know which users you would like to sync from your SCIM IdP to Wellness Coach.

Configure SCIM

• Step 1. Sign in to the Wellness Coach Portal: https://portal.wellnesscoach.live

• Step 2. In the left sidebar, go to Advanced → SSO Configuration.

• Step 3. In SCIM Configuration, enable SCIM and save the configuration.

 

• When you enable SCIM and click the Save Configuration button, a SCIM token will be generated. Make sure to copy this SCIM token and save it to a place that you can easily access later.

• Use this link for tenant URL: https://ed.wellnesscoach.live/scim for configuring SCIM on your identity provider.

---

Default vs Custom Attribute Mapping

Default Attribute Mapping

In the default flow:

1. Wellness Coach gets attributes using the default SCIM attribute paths, such as:

   urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:joiningDate
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department

2. Wellness Coach resolves all incoming attributes → internal Wellness Coach Key.

Example: Default employee_id sync

Client SCIM payload:

Wellness Coach maps this to:

 

Custom Key mapping Flow (If you want to use custom attribute names)

You can define custom attribute names (example: “empNum”, “divisionCode”) and map them to our internal Wellness Coach Key.

Steps:

1. You can create custom keys inside Wellness Coach Portal

   • Step 1. Sign in to the Wellness Coach Portal: https://portal.wellnesscoach.live

   • Step 2. In the left sidebar, go to Advanced → SSO Configuration.

   • Step 3. In SCIM Configuration, click Attribute Mapping to open the mapping drawer.

Step 4. For each field, map your Custom Attribute Key to the corresponding Wellness Coach Key, then click Save All Mappings

In your IdP(Okta/Azure/...), you must send your custom attributes under enterprise extension namespace:

 

Important: Required Namespace

• All custom attributes MUST use:
  urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

---

How Wellness Coach Uses SCIM attributes

Internally, all SCIM attributes are standardized to Wellness Coach Key fields.

Example:

To configure SCIM in the IdP that you're using, you must have to setup SSO for the IdP. See the articles below:

• How to Configure SSO for IdP