---
sourceDocument: Australia Platform security
sourceDocumentLink: https://www.servicenow.com/docs/r/platform-security

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Platform security

ft:clusterId :

    - psec

bundleId :

    - psec

workflow :

    - Platform


---

# Create a Connection \& Credential alias

# Create a Connection \& Credential alias {#ariaid-title1}

* Release version: Australia
* 
* Updated August 11, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read

Define an alias to label a credential or connection record.

## Before you begin

Role required:

* The admin role is required to create an alias.
* The credential_admin and connection_admin roles have read access to the alias record.
{#connection-alias__ul_ayv_p4n_gdb}

## About this task

The Connection \& Credential alias defines an alias that labels a credential or
connection record. The alias contains these fields.

## Procedure

1. Navigate to AllConnections \& CredentialsConnection \& Credential Aliases.
2. Select New.
3. Complete the fields on the form.  
   {#connection-alias__table_bbg_xmn_gdb__entry__2}

   | Field | Description |
   |-|-|
   | Name | Name of the alias. An alias can only contain alpha, number, and underscore characters. During an upgrade, the tag in the credential record migrates to a Connection \& Credential Alias. If the credential tag contains special characters other than alphabets, numbers, and underscores, it preserves the tag name after the upgrade. You can still use this migrated alias, but you can't update the alias until you change the name to meet the naming restrictions. |
   | ID | Unique identifier for the Connections \& Credentials alias, based on the format `scope_name.alias_name`. * If the scope is Global, the ID is the alias name. For example, if you create a Workday alias in the global scope, it sets the ID to `workday`. * If you create a workday alias in the HR app scope, it sets the ID to `x_hr_app.workday`. {#connection-alias__ul_yhj_vzk_vlb} |
   | Type | Select either Credential or Connection and Credential. The default is Connection and Credential. |
   | Application | Application scope against which the Connection \& Credentials alias is assigned. The current session scope you last selected in the application picker appears. * For example, Global appears if it is the current scope for this session. * You can change the scope in the application picker before creating an alias. To learn more application scopes and how to select them, see: * [Application scope](https://www.servicenow.com/docs/access?context=c_ApplicationScope&version=australia&pubname=australia-application-development&ft:locale=en-US) * [Select an application from the application picker](https://www.servicenow.com/docs/access?context=t_SelectAnAppFromTheAppPicker&version=australia&pubname=australia-platform-administration&ft:locale=en-US) {#connection-alias__ul_wng_h4w_wlb} {#connection-alias__ul_hg1_zqs_vlb} |
   | Connection type | Name of the connection type, either Basic, HTTP, JDBC, JMS, or Kafka. The default is HTTP. |
   | Support Multiple Active Connections | Designator that indicates whether the alias supports multiple active connections. Add connections using the Connections table and associated them to the alias using the Connections related list. |
   | Default Retry Policy | Retry policy for the alias. For more information, see [Retry policy](https://www.servicenow.com/docs/access?context=retry-policy&version=australia&pubname=australia-build-workflows&ft:locale=en-US). |
   | Configuration Template | Configuration template to use to create a connection and credential record. |
   [Table 1. Connection \& credential aliases]

   {#connection-alias__table_bbg_xmn_gdb}
4. Right-click the header and select Save.  
   The Connections and Connection Attributes related list appears.  
   {#connection-alias__table_bww_5lj_zlb__entry__2}

   | Related List | Description |
   |-|-|
   | Connections | Related connection records associated with this alias. After creating the alias, you can define connection records and associate them with the alias. If Support Multiple Active Connections is selected, you can associate more than one connection with an alias. |
   | Connection Attributes | Attributes for the connection. Define data specific to a connection and use it in an Integration Hub integration step. For more information, see [Create connection attributes for IntegrationHub](https://www.servicenow.com/docs/nSis8XdDbdurBtgKD2AZFg "Define connection-specific variables that you can use in Integration Hub integration steps."). |
   | Child Aliases | Child aliases associated with the parent alias. After creating a connection and credential alias, you can create child alias to configure multiple connections for the same application integration. |
   [ ]

   {#connection-alias__table_bww_5lj_zlb}
5. **Optional:** If you want to create a credential and connection associated with your credential alias, under Related Links, select Create New Connection \& Credential.  
   The resulting connection and credential records are based on a pre-defined configuration template. See [connection and credential configuration templates](https://www.servicenow.com/docs/U17UcXnyDXHe861Qh55IzA "Enable users with the admin and flow_designer roles to set up spoke integrations with third-party systems using a single, customizable form.").
6. **Optional:** If you want to create a child alias for your connection and credential alias, under the Child Aliases related list, select New.
   1. Enter a name for the child alias and select Submit.  
      The child alias inherits properties from the parent alias. You can then configure a child alias to contain its own set of connection and credential information.
   {#connection-alias__substeps_mvr_j1k_zlb}
{#connection-alias__steps_jvz_s4n_gdb}

## What to do next

Create one or more connection records to associate with the alias or child aliases. For
more information about creating connections, see [Get started with connections](https://www.servicenow.com/docs/ZXiO~ABeGl86bYuTd_01NQ "Use the connections table to set up a Basic, JMS, JDBC, or HTTP(s) connection to a target host."). Add connection attributes to the alias
to make connection meta data available to flows in Workflow Studio.

*[\>]: and then