---
sourceDocument: Brazil Platform security
sourceDocumentLink: https://www.servicenow.com/docs/r/platform-security

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Platform security

ft:clusterId :

    - psec

bundleId :

    - psec

workflow :

    - Platform


---

# Create a REST message

# Create a REST message {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
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 AllSystem Web ServicesOutboundREST Message.
2. Select New.
3. On the form, fill in the fields.  
   {#create-a-rest-message__table_z3g_llg_btb__entry__2}

   | Field | Description |
   |-|-|
   | Name | Descriptive name for this message. |
   | Endpoint | Base URL of SCIM Provider. For example, `https://example.service-now.com/api/now/scim`. |
   | Authentication Type | Type of authentication to be used to connect to the external SCIM Provider. For more information, see [Outbound REST authentication](https://www.servicenow.com/docs/access?context=c_OutboundRESTAuth&version=brazil&pubname=brazil-api-reference&ft:locale=en-US). |
   | HTTP Headers | 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` |
   [Table 1. SCIM Provider]

   {#create-a-rest-message__table_z3g_llg_btb}
4. In the  HTTP Methods  related list, select  New.
5. Configure the following HTTP Methods.  
   Note:  
   The URLs have variables that you must replace.
   {#create-a-rest-message__table_j4b_knp_2tb__entry__2}

   | Methods | Sample 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} |
   [Table 2. HTTP Methods]

   {#create-a-rest-message__table_j4b_knp_2tb}  
   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.
   {#create-a-rest-message__ul_alx_45j_htb}
6. Select 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](https://www.servicenow.com/docs/Qc4Y2KCbnaLOrrLikOslzg "Create a SCIM Provider to fetch resource types and schemas information from the SCIM Provider with the REST message. Enable the configuration of the HTTP Method (PUT or PATCH) to update a resource in the SCIM Provider.").

To learn more about how to create a REST message, see [Create a REST
message](https://www.servicenow.com/docs/access?context=t_ConfiguringARESTMessage&version=brazil&pubname=brazil-api-reference&ft:locale=en-US).

*[\>]: and then