Create a connection and credential in Virtual Agent Bot Interconnect
Create a connection and credential in Virtual Agent Bot Interconnect (primary instance) to enable uploading of attachments in the secondary bot.
Before you begin
Role required: admin
Procedure
-
Navigate to All > Connections & Credentials > Connection & Credential Aliases.
-
Click the Bot Interconnect VA API Attachment record to open it.
-
In the Connections related list, click New.
-
On the form, fill in the fields.
Field Description Name Enter a unique name, such as SNowSecondaryBotAttachment.Credential Leave this blank for now. Connection alias Use the default value. Connection URL Enter the URL of your secondary instance. For example, enter https://secondary-instance-name.service-now.com/. -
Click Submit.
-
Navigate to All > Connections & Credentials > Credentials.
-
On the Credentials page, click New.
-
Click either Basic Auth Credentials or OAuth 2.0 Credentials as the type.
-
On the form, fill in the fields.
Field Description Name Enter a unique name for the credential. For example, SNowSecondaryBotAttachmentToken.Basic Auth Credentials Username Enter the username you want to send as basic authentication credential.. Password Enter the password you want to send as basic authentication credential. OAuth 2.0 Credentials OAuth Entity Profile In the OAuth profile field, select the OAuth 2.0 profile that specifies the credentials you want to send. -
Click Submit.
-
Navigate to All > Connections & Credentials > Connection & Credential Aliases.
-
Click the Bot Interconnect VA API Attachment record to open it.
-
In the Connections related list, open the new connection record you created in an earlier step.
-
In the Credential field, enter the name of the record that contains the static token or hash token.
For example,
SNowSecondaryBotAttachmentToken.[Omitted image "api-secondary-bot-attachment-connection-credential.png"] Alt text: ServiceNow Secondary Bot HTTPS connection view. Credential and Connection URL fields are highlighted as newly created credential record and VA API installation on the secondary bot instance.
-
Click Update.
---
title: Create a connection and credential in Virtual Agent Bot Interconnect
description: Create a connection and credential in Virtual Agent Bot Interconnect \(primary instance\) to enable uploading of attachments in the secondary bot.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/conversational-interfaces/create-connection-credential-two-sn-instances-uploading-attachments.html
release: brazil
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Create a connection and credential in Virtual Agent Bot Interconnect, Using ServiceNow Virtual Agent as a secondary bot, Virtual Agent Bot Interconnect, Conversational Interfaces]
---
# Create a connection and credential in Virtual Agent Bot Interconnect
Create a connection and credential in Virtual Agent Bot Interconnect \(primary instance\) to enable uploading of attachments in the secondary bot.
## Before you begin
Role required: admin
## Procedure
1. Navigate to **All** > **Connections & Credentials** > **Connection & Credential Aliases**.
2. Click the **Bot Interconnect VA API Attachment** record to open it.
3. In the Connections related list, click **New**.
4. On the form, fill in the fields.
|Field|Description|
|-----|-----------|
|Name|Enter a unique name, such as `SNowSecondaryBotAttachment`.|
|Credential|Leave this blank for now.|
|Connection alias|Use the default value.|
|Connection URL|Enter the URL of your secondary instance. For example, enter `https://secondary-instance-name.service-now.com/`.|
5. Click **Submit**.
6. Navigate to **All** > **Connections & Credentials** > **Credentials**.
7. On the Credentials page, click **New**.
8. Click either **Basic Auth Credentials** or **OAuth 2.0 Credentials** as the type.
9. On the form, fill in the fields.
|Field|Description|
|-----|-----------|
|Name|Enter a unique name for the credential. For example, `SNowSecondaryBotAttachmentToken`.|
|Basic Auth Credentials|
|Username|Enter the username you want to send as basic authentication credential..|
|Password|Enter the password you want to send as basic authentication credential.|
|OAuth 2.0 Credentials|
|OAuth Entity Profile|In the OAuth profile field, select the OAuth 2.0 profile that specifies the credentials you want to send.|
10. Click **Submit**.
11. Navigate to **All** > **Connections & Credentials** > **Connection & Credential Aliases**.
12. Click the **Bot Interconnect VA API Attachment** record to open it.
13. In the Connections related list, open the new connection record you created in an earlier step.
14. In the **Credential** field, enter the name of the record that contains the static token or hash token.
For example, `SNowSecondaryBotAttachmentToken`.
\[Omitted image "api-secondary-bot-attachment-connection-credential.png"\] Alt text: ServiceNow Secondary Bot HTTPS connection view. Credential and Connection URL fields are highlighted as newly created credential record and VA API installation on the secondary bot instance.
15. Click **Update**.
| title | Create a connection and credential in Virtual Agent Bot Interconnect |
| description | Create a connection and credential in Virtual Agent Bot Interconnect \(primary instance\) to enable uploading of attachments in the secondary bot. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/conversational-interfaces/create-connection-credential-two-sn-instances-uploading-attachments.html |
| release | brazil |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 1 |
| breadcrumb | Create a connection and credential in Virtual Agent Bot InterconnectUsing ServiceNow Virtual Agent as a secondary botVirtual Agent Bot InterconnectConversational Interfaces |