Create a REST message

You can 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 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.

    See List of HTTP Header Fields for a list of HTTP header fields.

  4. Click Submit.

    ServiceNow saves the record and automatically creates HTTP methods (get, put, post, and delete).

What to do next

After creating the REST message, you can define new HTTP methods and run a request.