Thank you for your feedback.
Form temporarily unavailable. Please try again or contact to submit your comments.
  • Madrid
  • London
  • Kingston
  • Jakarta
  • Istanbul
  • Helsinki
  • Geneva
  • Store

Configure a REST message with basic auth

Log in to subscribe to topics and get notified when content changes.

Configure a REST message with basic auth

You can configure an outbound REST message to provide basic authentication credentials with each request.

Before you begin

Role required: web_service_admin
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.


  1. Navigate to System Web Services > Outbound > REST 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.

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.