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
Navigate to All > System Web Services > REST Message.
Click New.
Complete the following fields:
| 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. |
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.
Parent Topic:Outbound REST web service