How can we help?

Set up Guide: 10KC SCIM v2.0 Integration

Emily B
Emily B
  • Updated

Background

Ten Thousand Coffees (10KC) is an enterprise software platform for mentoring, networking and informal talent development experiences used by the world’s top organizations.

10KC’s SCIM v2.0 integration streamlines and automates adding, updating, and deleting member profiles.

Integration Setup

1. Configure SCIM server

Ten Thousand Coffees authenticates via a Bearer Token passed in the HTTP authorization header. We will share an Endpoint and Bearer Token with you via email.

2. Decide on user profile attributes

None of the fields below are required except for First Name, Last Name, and Email Address. The remaining fields in the list are recommended, and we explain why below, along with data spec requirements.

Field name

Why we recommend

Column Heading Override XML Alias

Data spec requirements

First Name*

* We require this field to invite members to your 10KC hub.

first_name

Can be any alpha-numeric string.

Last Name*

* We require this field to invite members to your 10KC hub.

last_name

Can be any alpha-numeric string.

Email Address*

* We require this field to invite members to your 10KC hub.

email

Can be any alpha-numeric string.

Employee ID

To rectify reporting issues if a member changes their email address.

employee_id

Can be any alpha-numeric string.

Program Eligibility

So we only invite eligible participants.

 

We can also potentially use one of the other fields in this list, such as “Business Unit”.

program_eligibility

We expect the values “eligible” or “ineligible”

Status

To de-activate profiles for employees that are on leave.

status

We expect the values “active” or “inactive”. They are case-sensitive.

Job Function, Job Family, or Management Level

For creating relevant matches by keeping these attributes in sync with your HRIS or Identity Management Software.

 

 

job_function

Can be any alpha-numeric string. Ideally it’s easy for members to read and understand.

Hire Start Date

For creating relevant matches by keeping these attributes in sync with your HRIS or Identity Management Software.

 

 

hire_start_date

We expect the format MM/DD/YYYY.

Business Unit, Supervisor Organization, or Department

For creating relevant matches by keeping these attributes in sync with your HRIS or Identity Management Software.

 

 

business_unit

Can be any alpha-numeric string. Ideally it’s easy for members to read and understand.

Office Location

For creating relevant matches by keeping these attributes in sync with your HRIS or Identity Management Software.

 

 

office_location

Can be any alpha-numeric string.

People Manager Status

For creating relevant matches by keeping these attributes in sync with your HRIS or Identity Management Software.

 

 

people_manager_status

We expect “yes” or “no”.

High Potential Status

For creating relevant matches by keeping these attributes in sync with your HRIS or Identity Management Software.

 

 

high_potential_status

We expect “yes” or “no”.

Diversity dimensions

 

(e.g. gender)

 

For creating relevant matches by keeping these attributes in sync with your HRIS or Identity Management Software.

 

gender

Can be any alpha-numeric string.

First Level Supervisor

To provide reporting for 3-4 levels under the CEO

first_level_supervisor

Can be any alpha-numeric string. Ideally it’s easy for members to read and understand.

Second Level Supervisor

To provide reporting for 3-4 levels under the CEO

second_level_supervisor

Can be any alpha-numeric string. Ideally it’s easy for members to read and understand.

Third Level Supervisor

To provide reporting for 3-4 levels under the CEO

third_level_supervisor

Can be any alpha-numeric string. Ideally it’s easy for members to read and understand.

Locale

To automatically localize 10KC in the user’s preference (if the preferred language is available)

locale

We currently only support two values:

 

• “fr-CA” for French(Canada)

 

• “en-US” for English(US)

 

Note: any blank values will be set as “en-US”

Most Recent Role Start Date

To enable mobility analyses

most_recent_role_start_date

We expect the format MM/DD/YYYY

Role Reason Change Code

To enable mobility analyses

role_reason_change_code

Can be any alpha-numeric string.

3. Assign users to 10KC

In your SCIM server, assign users and groups to the 10KC application. To unlock retention and career mobility insights, we recommend allowing all members of your organization the option to join 10KC.

Security Considerations

Security Measures

10KC has strict security policies and we follow all best practices like annual pen-testing, annual internal audit, third party SOC2 audit and aligning with regional data privacy requirements.

Ten Thousand Coffees uses WorkOS to enable Okta SCIM v2.0 connections for our enterprise customers. WorkOS is SOC 2 Type certified, GDPR and CCPA compliant, and performs annual 3rd-party security penetration tests, as well as external code audits. More detailed documentation on their security practices can be found here.

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.