Skip to content
SCIM Client › System for Cross-domain Identity Management \(SCIM\) › Identity
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create a REST message

Configure a REST message for all outbound calls for a particular SCIM Provider.

Before you begin

Role required: scim_client_config_admin

Procedure

  1. Navigate to All > System Web Services > Outbound > REST Message.

  2. Click New.

  3. On the form, fill in the fields.

FieldDescription
NameDescriptive name for this message.
EndpointBase URL of SCIM Provider. For example, `https://example.service-now.com/api/now/scim`.
Authentication TypeType of authentication to be used to connect to the external SCIM Provider. For more information see, Outbound REST authentication.
HTTP HeadersThe content type that is expected from the external SCIM Provider. For example, Header Name is the content type in the following API request body: `Content-type: application/scim+json`

  1. In the  HTTP Methods  related list, click  New.

  2. Configure the following HTTP Methods.

    Note: The URLs have variables that you must replace.

MethodsSample URL
GET`https://example.com/api/now/scim/${resourceName}`
PATCH`https://example.com/api/now/scim/${resourceName}/${resourceId}`
PUT`https://example.com/api/now/scim/${resourceName}/${resourceId}`
DELETE`https://example.com/api/now/scim/${resourceName}/${resourceId}`
POST`https://example.com/api/now/scim/${resourceName}/${resourceId}`
**Note:**

-   You must create all the HTTP methods for the operation of the SCIM Client.
-   A sample REST message is shipped from the base system.
Image omitted: rest-message.png
REST message
  1. Click Submit.

Result

The REST message record is created.

What to do next

Use the REST message to create a SCIM Provider. For more information, see Create a SCIM Provider.

To learn more about how to create a REST message, see Create a REST message.