letitflow-sn
← Back to App

Getting Started ​

Connect to ServiceNow ​

Open the web UI and click the gear icon in the nav bar to open the Settings panel. Configure:

  1. Instance URL — your ServiceNow instance (e.g., https://myco.service-now.com)
  2. Auth method — OAuth2 Client Credentials or Basic Auth
  3. Credentials — click Test Connection to verify

See the Setup Guide for a step-by-step walkthrough.

Authentication ​

Two authentication methods are supported. OAuth2 is recommended.

Uses a Client ID + Client Secret to obtain a Bearer token. No user password needed.

ServiceNow setup:

  1. Create an OAuth Application Registry entry with Grant Type = Client Credentials
  2. Set an OAuth Application User on the registry entry
  3. Enable glide.oauth.inbound.client_credential.grant_type.enabled = true
  4. Minimum version: Washington DC release

Basic Auth ​

Uses username + password on every request. Works on all SN versions.

Browse Flows ​

Go to the Flows page to see all flows on your connected instance. Search and filter by name, type, or status. Click any flow to view its details or export it as YAML.

Export a Flow ​

From the Flows page, click a flow and choose Export YAML. This fetches the full flow definition — trigger, steps, conditions, values — and produces a clean YAML file.

The exported YAML includes a schema: nebula version marker and can be used to:

  • Review the flow structure in a readable format
  • Create a copy of the flow on another instance
  • Edit and push changes back with the update workflow

Create a Flow ​

Go to the Editor page. Write a YAML flow definition (or load a sample), then click Create to push it to ServiceNow.

A minimal flow looks like:

yaml
schema: nebula
name: Hello World Flow
type: flow
trigger:
  type: record_created
  table: incident
steps:
  - action: log
    inputs:
      message: "A new incident was created: $trigger.current.number"

See Creating Flows for the full guide.

Validate ​

The editor validates your YAML as you type — errors appear inline. You can also validate without a ServiceNow connection by clicking Validate in the editor toolbar.

Next Steps ​