Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

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.

    FieldDescription
    NameEnter a unique name, such as SNowSecondaryBotAttachment.
    CredentialLeave this blank for now.
    Connection aliasUse the default value.
    Connection URLEnter 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.

    FieldDescription
    NameEnter a unique name for the credential. For example, SNowSecondaryBotAttachmentToken.
    Basic Auth Credentials
    UsernameEnter the username you want to send as basic authentication credential..
    PasswordEnter the password you want to send as basic authentication credential.
    OAuth 2.0 Credentials
    OAuth Entity ProfileIn 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.

Image omitted: api-secondary-bot-attachment-connection-credential.png
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.
  1. Click Update.

Parent Topic:Create a connection and credential in Virtual Agent Bot Interconnect