Go to Mural
All Collections
Mural for Enterprises
SCIM
SCIM API for Enterprise customers

SCIM API for Enterprise customers

SCIM provides automated provisioning and user management for MURAL Enterprise accounts.
Mural avatar
Written by Mural. Updated over a week ago

Available for: Enterprise plan

Set up by: Company-level admin

Index

Deprovisioning and Provisioning using SCIM protocol

System for Cross-domain Identity Management, also known as SCIM, provides automated provisioning and user management for MURAL Enterprise accounts. SCIM will help your team create matching user accounts in all systems that your team needs access to. By adding SCIM to MURAL, we hope to streamline your workflows and help your team grow in MURAL.

Note: SAML based SSO must be properly set up and be functional in your Enterprise account before you start configuring automated provisioning. See the guide to configuring SAML SSO.

MURAL supports dedicated integrations with both Okta and Microsoft Azure AD.

To configure an Okta integration, install our Okta connector. Then, follow the Okta instructions.

To configure an Azure AD integration, install our Azure connector. Then, follow the Azure instructions.

Note: If you’re using Azure or Okta, you only need to follow the instructions on the above pages. If you’re not using either of these identity providers, set up a custom integration following the steps in our developer portal.

Supported Features

Detailed MURAL SCIM schema can be found here.

MURAL supports the following provisioning features:

  • GET /Users

    Get an overview of the members with a MURAL license

  • GET /Users/{id}
    Check the attributes of a member

  • POST /Users
    Create a new MURAL account

  • PATCH /Users/{id}
    Update an existing member's resource and overwrite values for specific attributes

  • PUT /Users/{id}
    Update an existing member's resource, overwriting all values for a member

Supported Attributes

In MURAL, each member has their own attributes linked to their MURAL account. Attributes are profile information that a member would typically set in the Profile Details page of their MURAL account. These attributes include the member's first name, last name and email.

MURAL profile field

SCIM attribute

email

email

name

givenName

surname

familyName

email

userName

N/A

userType

locked

active

avatar

profileUrl

username

id

Planned Features

These features are not supported, but are planned for the near future:

  • Linking IdP groups to MURAL workspaces, and moving members between workspaces

Configure SCIM API

MURAL's SCIM implementation targets the SCIM 2.0 protocol reference. To set up SCIM provisioning using the API and to test it in our test environment, please see this article on our Developer Portal.

Do you have thoughts about SCIM? Let us know! You can contact our Support team in the MURAL chat box, or email us at support@mural.co.

Did this answer your question?