Delay employee invite emails using SCIM start dates in Azure AD

When a new employee is provisioned in 15Five via SCIM, they receive an invite email immediately by default. Configuring a start date delays that email until the specified date, and the employee cannot log in before then.

Before You Begin

  • SCIM must already be configured and active between Azure AD and 15Five.
  • Add the start date to each individual before assigning them to the 15Five application in Azure AD for the first time. If a person is assigned without a start date, 15Five sends the invite email immediately.
  • Start dates must use the format MM/DD/YYYY.

Option 1: Create a start date attribute in Azure AD

Use this option to sync start dates automatically from Azure AD to 15Five.

  1. Store each employee's start date in an Azure AD extension attribute, such as extensionAttribute1.
  2. In Azure AD, navigate to Enterprise Applications and open the 15Five app.
  3. Go to Provisioning > Mappings and click Edit attribute list for customappsso.
  4. Enter urn:ietf:params:scim:schemas:extension:15Five:2.0:User:startDate in the Name field.
  5. Select String as the type.
  6. Click Add Attribute, then save.
  7. Navigate back to User Attribute Mappings.
  8. Click Add New Mapping at the bottom of the mappings table.
  9. Set Source Attribute to the extension attribute holding the start date (for example, extensionAttribute1).
  10. Set Target Attribute to urn:ietf:params:scim:schemas:extension:15Five:2.0:User:startDate.
  11. Click OK to save.

Option 2: Bulk import employees via CSV with a start date

Use this option when you want to pre-load employees in 15Five with start dates before Azure AD syncs their full profiles.

  1. Create a CSV file with two columns: email and start_date.
  2. Enter each employee's work email and start date in MM/DD/YYYY format.
  3. In 15Five, navigate to Settings > People and use the bulk import tool to upload the CSV.
  4. Wait for Azure AD to sync — remaining employee attributes will populate automatically using email as the unique identifier.

If Something Goes Wrong

Issue Check Fix
Invite email sent immediately despite start date Start date was added after the first Azure AD assignment Deactivate the employee in Azure AD, re-add the start date, then re-assign them to the 15Five app
Start date not syncing from Azure AD Attribute mapping for startDate is missing or misconfigured Verify the target attribute name matches exactly: urn:ietf:params:scim:schemas:extension:15Five:2.0:User:startDate
Start date format rejected Date stored in extension attribute uses wrong format Update the value to MM/DD/YYYY in Azure AD and trigger a manual sync
Employee not receiving invite on start date Send welcome email is unchecked in SCIM settings In 15Five SCIM settings, confirm Send welcome email is enabled

Not Covered Here

This article does not cover initial SCIM setup or configuring other attribute mappings in Azure AD.

Related Articles

Was this article helpful?

Sorry to hear that. Tell us what was missing →