Create a REST message

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 All > System Web Services > REST Message.
2. Click New.
3. Complete the following fields:

   Table 1. REST Message form

   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.

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
  Define an HTTP method such as GET or POST to send a request to a web service provider.
• Define a REST message HTTP header
  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
  You can configure a REST message HTTP method to be sent through a MID Server.
• Using special characters in URIs
  A REST function URI or function variable may use special characters, such as pipe (|) characters.