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

Configure your pipeline environments

Set up your app development production and non-production environments (for example, development, test, and/or staging) by adding the URLs and credentials used to access each instance.

Before you begin

Role required: admin

Note: Only users with the System Administrator (admin) role can define instance credentials for environments. Users with the App Engine Administrator [sn_app_eng_notify.app_engine_admin] role can view environment records; however, the Instance credential field is not visible.

Procedure

  1. In your production instance, navigate to All > App Engine > Pipelines and Deployments > Environments.

  2. Select New.

Image omitted: new-environment-purple.png
Creating a new environment
  1. On the form, fill in the fields.
FieldDescription
NameName of the environment. Enter a name that distinguishes the instance as a development, test, or production environment. For example, if you're defining a development environment, you could include `Dev` in the name.
Instance TypeThe type of environment you are defining:- Sandbox - Development - Testing - Staging - Production
Instance URLWeb address of your ServiceNow instance.
Instance IDThe instance_id sys_property for the instance.Note: The Instance ID is automatically generated when you complete all of the other fields and select Validate.
ApplicationApplication scope of the environment.
Instance credentialAuthentication data related to the instance that you're configuring as an environment.Note: If you are using OAuth 2.0 credentials, select the appropriate credential for the instance record. For example, on your development instance record, select the OAuth Dev credential, and for your test instance record, select the OAuth Test credential.
Is Controller?Identifies if this instance is a controller. This should be selected for the production environment record where you plan to manage deployment requests. For more information, see Configure your controller instance.
  1. Select Submit.

  2. Repeat the previous steps as you define each remaining environment in your pipeline.

    For example, if you defined a production environment, repeat the procedure again to define a development environment. Then repeat the procedure once more to define a test environment.