{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":1357,"path":"api-reference/web-services/t_ConfiguringARESTMessage.md","title":"Create a REST message","bundle":null,"doc_type":null,"release":"australia","body":"\n# Create a REST message\n\nSend requests to a REST web service endpoint by creating a REST message record.\n\n## Before you begin\n\nRole required: web\\_service\\_admin\n\n## Procedure\n\n1.  Navigate to **All** &gt; **System Web Services** &gt; **REST Message**.\n\n2.  Click **New**.\n\n3.  Complete the following fields:\n\n<table id=\"table_RestMessageForm\"><thead><tr><th>\n\nField\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nName\n\n</td><td>\n\nEnter a descriptive name for this message.\n\n</td></tr><tr><td>\n\nEndpoint\n\n</td><td>\n\nEnter the endpoint that this REST message is sent to. The endpoint value may include variables using the format **$\\{variable\\}**.\n\n</td></tr><tr><td>\n\nAuthentication type\n\n</td><td>\n\nSelect 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.\n\n 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.\n\n</td></tr><tr><td>\n\nHTTP Headers\n\n</td><td>\n\nDouble-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.\n\n</td></tr></tbody>\n</table>4.  Click **Submit**.\n\n    After creating the REST message, a GET HTTP method is created automatically using the values from the REST message record.\n\n\n## What to do next\n\nCreate or edit HTTP methods and run a request.\n\n-   **[Define a REST message HTTP method](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/web-services/t_DefineAnHTTPMethod.md)**  \nDefine an HTTP method such as GET or POST to send a request to a web service provider.\n-   **[Define a REST message HTTP header](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/web-services/t_DefineAnHTTPHeader.md)**  \nDefine an HTTP header for a REST message or HTTP method to send that header with REST requests.\n-   **[Sending outbound REST messages through a MID Server](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/web-services/c_OutboundRESTMIDServerSupport.md)**  \nYou can configure a REST message HTTP method to be sent through a MID Server.\n-   **[Using special characters in URIs](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/web-services/c_UsingSpecialCharactersInURIs.md)**  \nA REST function URI or function variable may use special characters, such as pipe \\(\\|\\) characters.\n\n**Parent Topic:**[Outbound REST web service](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/web-services/c_OutboundRESTWebService.md)\n\n"}}