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.

<table id=“table_z3g_llg_btb”><thead><tr><th>

Field

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Name

</td><td>

Descriptive name for this message.

</td></tr><tr><td>

Endpoint

</td><td>

Base URL of SCIM Provider. For example, https://example.service-now.com/api/now/scim.

</td></tr><tr><td>

Authentication Type

</td><td>

Type of authentication to be used to connect to the external SCIM Provider. For more information see, Outbound REST authentication.

</td></tr><tr><td>

HTTP Headers

</td><td>

The 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

</td></tr></tbody> </table>4. In the HTTP Methods related list, click New.

1. Configure the following HTTP Methods.

   Note: The URLs have variables that you must replace.

<table id=“table_j4b_knp_2tb”><thead><tr><th>

Methods

</th><th>

Sample URL

</th></tr></thead><tbody><tr><td>

GET

</td><td>

https://example.com/api/now/scim/${resourceName}

</td></tr><tr><td>

PATCH

</td><td>

https://example.com/api/now/scim/${resourceName}/${resourceId}

</td></tr><tr><td>

PUT

</td><td>

https://example.com/api/now/scim/${resourceName}/${resourceId}

</td></tr><tr><td>

DELETE

</td><td>

https://example.com/api/now/scim/${resourceName}/${resourceId}

</td></tr><tr><td>

POST

</td><td>

https://example.com/api/now/scim/${resourceName}/${resourceId}

</td></tr></tbody> </table> 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.
\[Omitted image "rest-message.png"\] Alt text: 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.