---
sourceDocument: Xanadu API Reference
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Create a REST message

# Create a REST message {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Send requests to a REST web service endpoint by creating a REST message record.

## Before you begin

Role required: web_service_admin

## Procedure

1. Navigate to AllSystem Web ServicesREST Message.
2. Click New.
3. Complete the following fields:  
   {#t_ConfiguringARESTMessage__table_RestMessageForm__entry__2}

   | Field | Description |
   |-|-|
   | Name | Enter a descriptive name for this message. |
   | Endpoint | Enter the endpoint that this REST message is sent to. The endpoint value may include variables using the format ${variable}. |
   | Authentication type | Select the type of authentication to use, if any, and the profile record that contains the user credentials. Outbound REST supports basic authentication and OAuth 2.0. Outbound REST supports mutual authentication with basic authentication only. Authentication configured here is inherited by the associated HTTP methods. You can configure authentication for each method which overrides any authentication setting at the message level. |
   | HTTP Headers | Double-click a row in the HTTP Headers embedded list to define the header Name and Value. The web service provider determines which headers are supported or required. |
   [Table 1. REST Message form]

   {#t_ConfiguringARESTMessage__table_RestMessageForm}
4. Click Submit.  
   After creating the REST message, a GET HTTP method is created automatically using the values from the REST message record.

## What to do next

Create or edit HTTP methods and run a request.
* **[Define a REST message HTTP method](https://servicenow-prod.fluidtopics.net/awDKnceX~oUH~bkzEGQf0w)**   
  Define an HTTP method such as GET or POST to send a request to a web service provider.
* **[Define a REST message HTTP header](https://servicenow-prod.fluidtopics.net/OMt4wyL~CCZfKbjweKwajQ)**   
  Define an HTTP header for a REST message or HTTP method to send that header with REST requests.
* **[Sending outbound REST messages through a MID Server](https://servicenow-prod.fluidtopics.net/5qtle5m45LurlKzKxSMLcA)**   
  You can configure a REST message HTTP method to be sent through a MID Server.
* **[Using special characters in URIs](https://servicenow-prod.fluidtopics.net/7jeMjfX41b~KBLsInGAa3A)**   
  A REST function URI or function variable may use special characters, such as pipe (\|) characters.

*[\>]: and then