---
sourceDocument: Yokohama Conversational Interfaces
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Conversational Interfaces

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Configure the output response REST endpoint and outbound authentication for the Virtual Agent API

# Configure the output response REST endpoint and outbound authentication for the Virtual Agent API {#ariaid-title1}

Release version: Yokohama  
Updated January 30, 2025  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Specify the outbound endpoint URL to which the Virtual Agent responses
are posted. Configure outbound authentication.

## Before you begin

If needed, specify the Message Authentication for token validation in the Provider Channel Identities \[sys_cs_provider_application\] table.

Role required: admin

## Procedure

1. Navigate to AllSystem Web ServicesOutboundREST Message.
2. Select the VA Bot to Bot record to open it.
3. In the Endpoint field, enter the response endpoint for the third-party bot, and then click Update.  
   This is the endpoint for the primary bot server, where the response will have
   to be sent from the ServiceNow bot to another bot or
   another ServiceNow instance.

   For example: <kbd class="ph userinput">http://&lt;customer instance&gt;/demo/rest/service/nowbot/processResponse</kbd>
4. In the Authentication tab, set the Authentication type field to either Basic or OAuth 2.0, and then click Update.  
   * Basic: In the Basic auth profile field, select or create a Basic auth profile. It will contain a username and password.

   * OAuth: In the OAuth profile field, select or create an OAuth profile. After saving your changes, click Get OAuth Token in the related links list.
   {#configure-response-endpoint-va-api__ul_fmf_pfq_wqb}

   For details about configuring basic authentication, see Configure a REST message with basic auth.
   For information about configuring OAuth 2.0, see Configure a REST message with OAuth.
5. Review the JSON response returned from the endpoint call.  
   For a description of the Virtual Agent API response parameters and an example of a successful response, see Virtual Agent Bot Integration API.
{#configure-response-endpoint-va-api__steps_ptd_222_rmb}

*[\>]: and then