Installation

Download the binary for your platform from flowctl.sh/download.

macOS / Linux

curl -fsSL https://flowctl.sh/install | sh

Or download manually:

# macOS Apple Silicon
wget https://flowctl.sh/releases/latest/flowctl-darwin-arm64
chmod +x flowctl-darwin-arm64
sudo mv flowctl-darwin-arm64 /usr/local/bin/flowctl

Windows

Download flowctl-windows-amd64.exe from flowctl.sh/download and add it to your PATH.

Verify

flowctl --version

Authentication

flowctl talks to ServiceNow’s REST API. You need credentials.

OAuth2 (recommended):

export SN_CLIENT_ID=your_client_id
export SN_CLIENT_SECRET=your_client_secret
flowctl --instance https://myco.service-now.com --sys-id abc123...

Basic Auth:

export SN_PASSWORD=your_password
flowctl --instance https://myco.service-now.com --sys-id abc123... --user admin

Both methods work in all tiers. OAuth2 is better for production — no password, token auto-refreshes.

OAuth2 Setup in ServiceNow

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

---

Need to create or update flows? See Pro features