---
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


---

# Configure a REST message with basic auth

# Configure a REST message with basic auth {#ariaid-title1}

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

Configure an outbound REST message to provide basic authentication credentials with each request.

## Before you begin

Before starting this procedure, ensure there is a REST Message record that you want to configure to use basic auth.  
Note:  
Ensure any scripts that call this REST message use the RESTMessageV2 API. The RESTMessageV2 API is required to send authenticated REST messages via scripts.

Role required: web_service_admin

## Procedure

1. Navigate to AllSystem Web ServicesOutboundREST Message.
2. Select a REST message record.
3. In the Authentication type field, select Basic.  
   Note:  
   The Basic (Simple) choice appears on REST message records configured to use basic authentication prior to the Geneva release. This choice is intended for compatibility with older REST messages and should not be used for REST messages created in the Geneva release or later.
4. In the Basic auth profile field, select the basic authentication profile that contains the credentials you want to send.
5. Click Submit.
{#t_ConfigureRESTMsgBasicAuth__steps_ak2_sp4_3s}

## What to do next

Test the REST message to ensure you receive the expected response. You can optionally specify different authentication settings for each HTTP method related to this REST message, overriding the parent REST message settings.
* **[Create a basic auth profile](https://servicenow-prod.fluidtopics.net/8cZuTcFnP1somhgX_JngZg)**   
  Create a basic auth profile to specify basic authentication credentials for one or more REST messages.

*[\>]: and then