acc, the command line interface for Adobe Campaign developers

Save time, reduce risk, and improve code health with acc! This tool helps you develop on your Adobe Campaign Classic instances. It quickly downloads AC v7/v8 configuration: from schemas, to deliveries, to workflows and more! You can also use it to automate many common development tasks: query records in any schema, call soap methods...

Full documentation available on Getting started with acc.

Table of contents

• Features
• Quick Start
  • Installation
  • Usage
• Changelog
• Architecture & Security
• Command reference
• Advanced configuration

Features

• Authenticate to your AC instances via username/password, or OAuth Server-to-Sever
• Extract configuration (schemas, deliveries, forms...) from AC as local files (HTML, JS, CSS, XML)
• Version control these local files with Git to reduce risk when developing/migrating/upgrading
• Query records using read-only queryDef operations. For production target analysis & AI assistants
• Call SOAP methods on any schema via the NLWS functionality, for any recurring maintenance
• Use your tools like VSCode, syntax checks (prettier) and code checkers (eslint)
• Work anywhere on any instance: local, staging, production ; and any OS: Windows, macOS, Linux

acc addresses the challenge of managing AC configurations with JavaScript development rather than through the AC Client Console.

🚀 Quick Start

acc is a NodeJS CLI that is based on the official Adobe Campaign JS SDK (@adobe/acc-js-sdk). Install and update with npm.

Installation

Install acc globally by running:

npm install -g campaign-cli

First time authentication

After installation, initialize the authentication to your instance. This creates a local profile identified by an --alias.

acc auth init
# Host (i.e. https://instance1.campaign.adobe.com):
# Authentication method: (OAuth Server-to-Server, User + password)
# Path to the OAuth Server-to-Server JSON (i.e. ~/Downloads/oauth-s2s.json):
# Alias (i.e. staging):

Verify your local aliases by listing your instances:

acc auth list
# | staging | https://instance1.campaign.adobe.com | OAuth Server-to-Server |

Usage

Once authenticated, download the instance configuration:

acc instance pull
# Downloading
# ✔ /Administration/Configuration/Form rendering: xtk:formRendering
# ✔ /Administration/Configuration/Javascript codes: xtk:javascript
# ✔ /Administration/Campaign Management/Typology management/Typology rules: nms:typologyRule

It is best to run acc commands from a dedicated project directory. When you run a command like acc instance pull, the CLI will:

• Look for an acc.config.json in the current directory
• If missing, it automatically generates one with acc instance template
• Download files following the AC folder hierarchy (e.g., /Administration/Configuration/Javascript codes/)

📋 Changelog

Read the acc Changelog.

🔒 Architecture & Security

Read the acc Architecture & Security.

📖 Command reference

• acc auth decode TOKEN
• acc auth init
• acc auth ip
• acc auth list
• acc auth login
• acc config
• acc config clear
• acc config del KEYS
• acc config delete KEYS
• acc config edit
• acc config get KEY
• acc config list
• acc config ls
• acc config rm KEYS
• acc config set key 'a value' # set key to 'a value'
• acc info
• acc instance check
• acc instance exec
• acc instance info
• acc instance pull
• acc instance queryDef
• acc instance soap
• acc instance template
• acc instance watch
• acc monitor test
• acc report

acc auth decode TOKEN

Decode an access token. Use it to troubleshoot Adobe IMS authentication errors.

USAGE
  $ acc auth decode TOKEN [--json]

ARGUMENTS
  TOKEN  IMS Access token (starts with 'eyJ')

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Decode an access token. Use it to troubleshoot Adobe IMS authentication errors.

  Adobe Campaign authentication:
  https://experienceleague.adobe.com/en/docs/campaign-classic/using/technotes/ims/ims-migration

EXAMPLES
  Display the decoded information: issued at, expires at, organization id...

    $ acc auth decode "eyJhbGci…"

  Display the decoded information as a JSON object.

    $ acc auth decode "eyJhbGci…" --json

See code: src/commands/auth/decode.js

acc auth init

Authenticate an Adobe Campaign instance, save credentials (in global aio config), and calls auth login.

USAGE
  $ acc auth init [-a <value>] [--host <value>] [--method UserPassword|ImsBearerToken|ImsServerToServer]
    [--user <value>] [--pass <value>] [--token <value>] [--json-file <value>] [--ims-env prod|stage]

FLAGS
  -a, --alias=<value>      Local alias for this instance, e.g. prod, staging, local
      --host=<value>       URL of Adobe Campaign instance, e.g. https://instance1.campaign.adobe.com
      --ims-env=<option>   IMS environment for token generation (ImsServerToServer). Defaults to prod.
                           <options: prod|stage>
      --json-file=<value>  Path to the OAuth Server-to-Server JSON downloaded from the Developer Console (Credentials >
                           OAuth Server-to-Server > Download JSON). Implies --method ImsServerToServer. Keeps the client
                           secret out of your shell history, unlike passing it on the command line.
      --method=<option>    Authentication method. Defaults to UserPassword. Use ImsServerToServer to login via JSON from
                           the Developer Console OAuth Server-to-Server credentials, or use ImsBearerToken for a token
                           pasted by hand.
                           <options: UserPassword|ImsBearerToken|ImsServerToServer>
      --pass=<value>       Operator password (UserPassword method). Omit on an interactive terminal to be prompted
                           securely (avoids leaking it into shell history).
      --token=<value>      IMS bearer token (ImsBearerToken method), a JWT starting with 'eyJ'. Omit on an interactive
                           terminal to be prompted securely.
      --user=<value>       Operator username (UserPassword method)

DESCRIPTION
  Authenticate an Adobe Campaign instance, save credentials (in global aio config), and calls `auth login`.

  The currently supported authentication methods are:

  - OAuth Server-to-Server (preferred): a JSON file from the Adobe Developer Console, for instances with an IMS identity
  provider.
  - OAuth Access Token: a JWT token pasted by hand, for instances with an IMS identity provider.
  - Operator User/Password: the classic operator login, for local instances or instances without IMS.

  The `auth init` command saves credentials in the global aio config, and then logs in to the instance. The `auth login`
  command can be used later to re-login without re-entering credentials.

  Adobe Campaign authentication:
  https://experienceleague.adobe.com/en/docs/campaign-classic/using/technotes/ims/ims-migration

EXAMPLES
  Initialize authentication with menu selection (preferred).

    $ acc auth init

  For CI/CD: Initialize authentication with OAuth Server-to-Server method.

    $ acc auth init --alias prod --host https://instance1.campaign.adobe.com --method ImsServerToServer --json-file \
      ./oauth-s2s.json

  For CI/CD: Initialize authentication with OAuth Access Token method.

    $ acc auth init --alias prod --host https://instance1.campaign.adobe.com --method ImsBearerToken --token eyJ...

  For CI/CD: Initialize authentication with Operator User/Password method.

    $ acc auth init --alias local --host https://instance1.campaign.adobe.com --method UserPassword --user admin

See code: src/commands/auth/init.js

acc auth ip

Call api.db-ip.com and output your public IP address. Use it to troubleshoot IP whitelisting issues.

USAGE
  $ acc auth ip

DESCRIPTION
  Call api.db-ip.com and output your public IP address. Use it to troubleshoot IP whitelisting issues.

  Adobe Campaign authentication:
  https://experienceleague.adobe.com/en/docs/campaign-classic/using/technotes/ims/ims-migration

EXAMPLES
  Fetch IP and displays it as JSON. I.e. {ipAddress: "", countryCode: ""}

    $ acc auth ip

See code: src/commands/auth/ip.js

acc auth list

Read credentials (from global aio config) and display configured Adobe Campaign instances.

USAGE
  $ acc auth list [--json]

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Read credentials (from global aio config) and display configured Adobe Campaign instances.

  Must be ran after `auth init`.

EXAMPLES
  Display your instances as table

    $ acc auth list

  For CI/CD: Output as json

    $ acc auth list --json

See code: src/commands/auth/list.js

acc auth login

Read credentials (from global aio config) and login to an Adobe Campaign instance.

USAGE
  $ acc auth login -a <value>

FLAGS
  -a, --alias=<value>  (required) Local alias for this instance, e.g. prod, staging, local

DESCRIPTION
  Read credentials (from global aio config) and login to an Adobe Campaign instance.

  Must be ran after `auth init`.

EXAMPLES
  Read credentials for the json key 'local', and login. Usually for a local Adobe Campaign VM.

    $ acc auth login --alias local

  Read credentials for the json key 'prod', and login. Usually for a production Adobe Campaign instance.

    $ acc auth login --alias prod

See code: src/commands/auth/login.js

acc config

list, get, set, delete, and edit persistent configuration data

USAGE
  $ acc config [-l | -g] [-e] [--verbose |  | [-j | -y]]

FLAGS
  -e, --env      environment variables
  -g, --global   global config
  -j, --json     output in json
  -l, --local    local config
  -y, --yaml     output in yaml
      --verbose  show all config values

DESCRIPTION
  list, get, set, delete, and edit persistent configuration data

ALIASES
  $ acc config ls

EXAMPLES
  $ aio config:list

  $ aio config:get KEY

  $ aio config:set KEY VALUE

  $ aio config:delete KEY

  $ aio config:clear

See code: @adobe/aio-cli-plugin-config

acc config clear

clears all persistent config values

USAGE
  $ acc config clear [-l | -g] [-f]

FLAGS
  -f, --force   do not prompt for confirmation
  -g, --global  global config
  -l, --local   local config

DESCRIPTION
  clears all persistent config values

See code: @adobe/aio-cli-plugin-config

acc config del KEYS

deletes persistent config values

USAGE
  $ acc config del KEYS... [-l | -g]

FLAGS
  -g, --global  global config
  -l, --local   local config

DESCRIPTION
  deletes persistent config values

ALIASES
  $ acc config del
  $ acc config rm

acc config delete KEYS

deletes persistent config values

USAGE
  $ acc config delete KEYS... [-l | -g]

FLAGS
  -g, --global  global config
  -l, --local   local config

DESCRIPTION
  deletes persistent config values

ALIASES
  $ acc config del
  $ acc config rm

See code: @adobe/aio-cli-plugin-config

acc config edit

edit config file

USAGE
  $ acc config edit [-l | -g]

FLAGS
  -g, --global  global config
  -l, --local   local config

DESCRIPTION
  edit config file

See code: @adobe/aio-cli-plugin-config

acc config get KEY

gets a persistent config value

USAGE
  $ acc config get KEY [-l | -g] [-j | -y] [-e]

FLAGS
  -e, --env     environment variables
  -g, --global  global config
  -j, --json    output in json
  -l, --local   local config
  -y, --yaml    output in yaml

DESCRIPTION
  gets a persistent config value

See code: @adobe/aio-cli-plugin-config

acc config list

lists all persistent config values

USAGE
  $ acc config list [-l | -g] [-e] [--verbose |  | [-j | -y]]

FLAGS
  -e, --env      environment variables
  -g, --global   global config
  -j, --json     output in json
  -l, --local    local config
  -y, --yaml     output in yaml
      --verbose  show all config values

DESCRIPTION
  lists all persistent config values

ALIASES
  $ acc config ls

See code: @adobe/aio-cli-plugin-config

acc config ls

list, get, set, delete, and edit persistent configuration data

USAGE
  $ acc config ls [-l | -g] [-e] [--verbose |  | [-j | -y]]

FLAGS
  -e, --env      environment variables
  -g, --global   global config
  -j, --json     output in json
  -l, --local    local config
  -y, --yaml     output in yaml
      --verbose  show all config values

DESCRIPTION
  list, get, set, delete, and edit persistent configuration data

ALIASES
  $ acc config ls

EXAMPLES
  $ aio config:list

  $ aio config:get KEY

  $ aio config:set KEY VALUE

  $ aio config:delete KEY

  $ aio config:clear

acc config rm KEYS

deletes persistent config values

USAGE
  $ acc config rm KEYS... [-l | -g]

FLAGS
  -g, --global  global config
  -l, --local   local config

DESCRIPTION
  deletes persistent config values

ALIASES
  $ acc config del
  $ acc config rm

acc config set key 'a value' # set key to 'a value'

sets a persistent config value

USAGE
  $ acc config set key 'a value'       # set key to 'a value'
  $ acc config set key -f value.json   # set key to the json found in the file value.json
  $ acc config set -j key < value.json # set key to the json found in the file value.json

FLAGS
  -f, --file         value is a path to a file
  -g, --global       global config
  -i, --interactive  prompt for value
  -j, --json         value is json
  -l, --local        local config
  -y, --yaml         value is yaml

DESCRIPTION
  sets a persistent config value

See code: @adobe/aio-cli-plugin-config

acc info

Display dev environment version information

USAGE
  $ acc info [-y | -j]

FLAGS
  -j, --json  output raw json
  -y, --yml   output yml

DESCRIPTION
  Display dev environment version information

See code: @adobe/aio-cli-plugin-info

acc instance check

Compute how many records will be downloaded from an Adobe Campaign instance (via SOAP xtk:queryDef#ExecuteQuery). The query definitions are read from acc.config.json and control the data retrieval.

USAGE
  $ acc instance check [-a <value>] [-p <value>] [-c <value>] [-m <value>]

FLAGS
  -a, --alias=<value>     Local alias for this instance, e.g. prod, staging, local. Defaults to the alias field of
                          acc.config.json.
  -c, --config=<value>    [default: ./acc.config.json] Path to the configuration file.
  -m, --metadata=<value>  Comma-separated list of schema ids to retrieve, e.g. nms:delivery,nms:operation
  -p, --path=<value>      [default: current working directory] Path where the command should run.

DESCRIPTION
  Compute how many records will be downloaded from an Adobe Campaign instance (via SOAP xtk:queryDef#ExecuteQuery). The
  query definitions are read from acc.config.json and control the data retrieval.
  Want to download data after a check? Use the `acc instance pull` command, which will run the same queries and store
  them as local files.

EXAMPLES
  Check records to be downloaded.

    $ acc instance check

  Check only the xtk:javascript records to be downloaded.

    $ acc instance check --metadata xtk:javascript

  Check records from your configured staging instance.

    $ acc instance check --alias staging

  Check records from the specified configuration file.

    $ acc instance check --config acc.marketing.config.json

See code: src/commands/instance/check.js

acc instance exec

Execute server-side JavaScript on an Adobe Campaign instance (xtk:builder#EvaluateJavaScript)

USAGE
  $ acc instance exec [-a <value>] [-p <value>] [-c <value>] [-f <value>] [-s <value>] [--name <value>]

FLAGS
  -a, --alias=<value>   Local alias for this instance, e.g. prod, staging, local. Defaults to the alias field of
                        acc.config.json.
  -c, --config=<value>  [default: ./acc.config.json] Path to the configuration file.
  -f, --file=<value>    Path to a JavaScript file to execute on the server
  -p, --path=<value>    [default: current working directory] Path where the command should run.
  -s, --script=<value>  Inline JavaScript to execute (alternative to --file)
      --name=<value>    Logical name of the script (defaults to the file basename, or 'acc-cli')

DESCRIPTION
  Execute server-side JavaScript on an Adobe Campaign instance (xtk:builder#EvaluateJavaScript)

EXAMPLES
  $ acc instance exec --alias staging --file ./scripts/cleanup.js

  $ acc instance exec --alias staging --script "context.res = application.instanceName"

See code: src/commands/instance/exec.js

acc instance info

Diagnostic report for an Adobe Campaign instance (xtk:session#TestCnx, #GetServerTime, #GetCnxInfo, nl:monitoring#DumpCurrentInstanceState)

USAGE
  $ acc instance info [-a <value>] [-p <value>] [-c <value>]

FLAGS
  -a, --alias=<value>   Local alias for this instance, e.g. prod, staging, local. Defaults to the alias field of
                        acc.config.json.
  -c, --config=<value>  [default: ./acc.config.json] Path to the configuration file.
  -p, --path=<value>    [default: current working directory] Path where the command should run.

DESCRIPTION
  Diagnostic report for an Adobe Campaign instance (xtk:session#TestCnx, #GetServerTime, #GetCnxInfo,
  nl:monitoring#DumpCurrentInstanceState)

EXAMPLES
  $ acc instance info --alias staging

See code: src/commands/instance/info.js

acc instance pull

Pull data with read-only queries from an Adobe Campaign instance (via SOAP xtk:queryDef#ExecuteQuery). The query definitions are read from acc.config.json and control the data retrieval.

USAGE
  $ acc instance pull [-a <value>] [-p <value>] [-c <value>] [-m <value>]

FLAGS
  -a, --alias=<value>     Local alias for this instance, e.g. prod, staging, local. Defaults to the alias field of
                          acc.config.json.
  -c, --config=<value>    [default: ./acc.config.json] Path to the configuration file.
  -m, --metadata=<value>  Comma-separated list of schema ids to retrieve, e.g. nms:delivery,nms:operation
  -p, --path=<value>      [default: current working directory] Path where the command should run.

DESCRIPTION
  Pull data with read-only queries from an Adobe Campaign instance (via SOAP xtk:queryDef#ExecuteQuery). The query
  definitions are read from acc.config.json and control the data retrieval.
  Want to check which records will be downloaded? Use the `acc instance check` command first, which will run the same
  queries but only return the record counts.

EXAMPLES
  Pull records and store them as local files.

    $ acc instance pull

  Pull only the xtk:javascript schema and store it as local files.

    $ acc instance pull --metadata xtk:javascript

  Pull records from your configured staging instance and store them as local files.

    $ acc instance pull --alias staging

  Pull records from the specified configuration file and store them as local files.

    $ acc instance pull --config acc.marketing.config.json

See code: src/commands/instance/pull.js

acc instance queryDef

Run a read-only query on an Adobe Campaign instance (via SOAP xtk:queryDef#ExecuteQuery). Pass a queryDef as JSON; it is read-only by construction (no writes, read-only permission compatible), a safe alternative to instance exec.

USAGE
  $ acc instance queryDef [--json] [-a <value>] [-p <value>] [-c <value>] [-q <value>] [-f <value>]

FLAGS
  -a, --alias=<value>   Local alias for this instance, e.g. prod, staging, local. Defaults to the alias field of
                        acc.config.json.
  -c, --config=<value>  [default: ./acc.config.json] Path to the configuration file.
  -f, --file=<value>    Path to a .json file containing the queryDef (alternative to --query)
  -p, --path=<value>    [default: current working directory] Path where the command should run.
  -q, --query=<value>   queryDef as a JSON string (alternative to --file)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Run a read-only query on an Adobe Campaign instance (via SOAP xtk:queryDef#ExecuteQuery). Pass a queryDef as JSON; it
  is read-only by construction (no writes, read-only permission compatible), a safe alternative to `instance exec`.
  Adobe Campaign querydef:
  https://experienceleague.adobe.com/en/docs/campaign-classic/using/configuring-campaign-classic/api/data-oriented-apis

EXAMPLES
  Get an option in XML format (SQL Read, queryDef Get). Result: <option stringValue="..."/>

    $ acc instance queryDef --query '<queryDef schema="xtk:option" operation="get"><select><node expr="@stringValue" \
      /></select></queryDef>'

  Get an option in JSON format (SQL Read, queryDef Get). Result: {stringValue: "..."}

    $ acc instance queryDef --query '{"schema":"xtk:option", "operation": "get", "select": {"node": [{"expr": \
      "@stringValue"}] } }' --json

  For big or recurrent queries, consider saving them in a file: get a list of recipients (SQL Read, queryDef select)

    $ acc instance queryDef --file ./queries/recipients.json --json

See code: src/commands/instance/queryDef.js

acc instance soap

Call any SOAP method on an Adobe Campaign instance (e.g. nms:delivery#BuildPreviewFromId, xtk:session#GetServerTime).

USAGE
  $ acc instance soap -s <value> -m <value> [--json] [-a <value>] [-p <value>] [-c <value>] [--args <value>]

FLAGS
  -a, --alias=<value>   Local alias for this instance, e.g. prod, staging, local. Defaults to the alias field of
                        acc.config.json.
  -c, --config=<value>  [default: ./acc.config.json] Path to the configuration file.
  -m, --method=<value>  (required) Method name (PascalCase or camelCase accepted), e.g. BuildPreviewFromId
  -p, --path=<value>    [default: current working directory] Path where the command should run.
  -s, --schema=<value>  (required) Schema id, e.g. nms:delivery, xtk:session
      --args=<value>    Method arguments as a JSON array, e.g. '[1234, "<params/>"]'. Omit for methods that take no
                        argument.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Call any SOAP method on an Adobe Campaign instance (e.g. nms:delivery#BuildPreviewFromId, xtk:session#GetServerTime).
  Works with static methods only (non-static methods are not supported)
  Powerful: it can reach all methods, use with care.

  Adobe Campaign SOAP: https://experienceleague.adobe.com/en/docs/campaign-classic/using/configuring-campaign-classic/ap
  i/soap-methods-in-javascript

EXAMPLES
  Get the server time

    $ acc instance soap --schema xtk:session --method GetServerTime

  Convert HTML to text-only with nms:delivery#HtmlToText method

    $ acc instance soap --schema nms:delivery --method HtmlToText --args '["<p>Hello</p>"]'

  Preview the delivery 1234 with the recipient 1000

    $ acc instance soap -s nms:delivery -m BuildPreviewFromId --args '[1234, {"content": "html", "filter": "@id = \
      1000"}]' --json

See code: src/commands/instance/soap.js

acc instance template

Output a template configuration file

USAGE
  $ acc instance template

DESCRIPTION
  Output a template configuration file

EXAMPLES
  Output the template in the console.

    $ acc instance template

  Output the template in a file.

    $ acc instance template > acc.config.json

See code: src/commands/instance/template.js

acc instance watch

Watch decomposed files and push changes to Adobe Campaign instance. Only files with 'decompose' configuration in acc.config.json are watched.

USAGE
  $ acc instance watch [-a <value>] [-p <value>] [-c <value>] [--debounce <value>]

FLAGS
  -a, --alias=<value>     Local alias for this instance, e.g. prod, staging, local. Defaults to the alias field of
                          acc.config.json.
  -c, --config=<value>    [default: ./acc.config.json] Path to the configuration file.
  -p, --path=<value>      [default: current working directory] Path where the command should run.
      --debounce=<value>  [default: 300] Debounce time in milliseconds to wait after file changes before pushing
                          (default: 300)

DESCRIPTION
  Watch decomposed files and push changes to Adobe Campaign instance. Only files with 'decompose' configuration in
  acc.config.json are watched.

EXAMPLES
  Watch decomposed files and push changes to the staging instance

    $ acc instance watch --alias staging

  Watch decomposed files in ./src directory and push changes to the staging instance

    $ acc instance watch --alias staging --path ./src

  Watch decomposed files with a 500ms debounce delay

    $ acc instance watch --alias local --debounce 500

See code: src/commands/instance/watch.js

acc monitor test

Health-check an instance via the anonymous /r/test endpoint (Apache front, no login)

USAGE
  $ acc monitor test [--host <value> | --alias <value>]

FLAGS
  --alias=<value>  Probe the host of a stored instance alias instead of --host
  --host=<value>   Instance root URL to probe anonymously, e.g. https://instance1.campaign.adobe.com

DESCRIPTION
  Health-check an instance via the anonymous /r/test endpoint (Apache front, no login)

See code: src/commands/monitor/test.js

acc report

Report an issue with the CLI or submit a feature request

USAGE
  $ acc report [-b | -f]

FLAGS
  -b, --bug      report an issue
  -f, --feature  request a feature

DESCRIPTION
  Report an issue with the CLI or submit a feature request

See code: @adobe/aio-cli-plugin-info

🛠️ Local development

# Clone repository
git clone https://github.com/myrosblog/acc-cli.git && cd acc-cli
npm install
npm test # unit tests & integration tests with XML samples
ACC_E2E_ALIAS=local npm run test:e2e # end-to-end tests against an instance
ACC_E2E_S2S_JSON=~/oauth-s2s.json npm run test:e2e # also exercise a Developer Console credential

Coding conventions, project structure and contributor guidelines live in AGENTS.md.

📤 Output & logging

acc follows the Unix convention so its output is safe to script:

• stdout carries the command result only, e.g. the XML returned by acc instance exec or the IP from `acc auth ip, raw and undecorated, so it pipes cleanly.
• stderr carries everything else: progress spinners, status, warnings and errors. Verbosity is controlled by AIO_LOG_LEVEL (info by default; set AIO_LOG_LEVEL=debug to troubleshoot).
• A rotating acc.log under the CLI cache directory keeps the full trace at all levels for audit/post-mortem, regardless of the console verbosity. Disable it with ACC_NO_FILE_LOG=1.

# Only the result reaches the pipe; diagnostics stay on the terminal (stderr)
acc instance exec --alias staging --script "context.@result = application.instanceName" | xmllint --format -

🔧 Advanced Configuration

For OAuth Server-to-Server, download the credential as JSON from the Adobe Developer Console (Credentials → OAuth Server-to-Server → Download JSON) and give acc its path. acc then generates and refreshes the IMS access tokens for you. Leave the path empty to paste the JSON instead.

The IMS bearer token is configured in the Adobe Developer Console and is short-lived (typically ~24h). Update acc.auth.instances via acc config when it expires. Debugging an IMS token? Check the advanced section to decode it to JSON and inspect its claims. When using user/password instances, no change is expected so keep working unchanged.

Read the Advanced Use Cases documentation

Auth can be fully scripted: acc auth init --host https://instance1.campaign.adobe.com --user username --pass 's3cret' --alias staging (or --method ImsBearerToken --token '...' for a hand-pasted IMS token, or --method ImsServerToServer --json-file ./oauth-s2s.json to generate IMS tokens automatically from the OAuth Server-to-Server credential downloaded from the Developer Console. --json-file implies that method and keeps the client secret out of your shell history)

Store the alias in acc.config.json ({"alias": "staging"}) to use it as default for all acc commands.

# Run a read-only SQL query with queryDef language
# Ideal as a production-safe data tool, including for AI agents.
acc instance queryDef -q '<queryDef schema="xtk:option" operation="get"><select><node expr="@stringValue" /></select></queryDef>'
# --json uses JSON as input + output; --file reads the queryDef from a .json file
acc instance queryDef -q '{schema:"xtk:option", operation:"get", select:{node:[{expr:"@stringValue"}]}}' --json
# -f to read the query from a file
acc instance queryDef -f scripts/queryDef.option.get.json --json

# Call any SOAP method on any schema (uses the acc-js-sdk NLWS proxy). Static methods only.
acc instance soap --schema xtk:session --method GetServerTime
# --args is a JSON array of the method parameters
acc instance soap -s nms:delivery -m HtmlToText --args '["<p>Hi</p>"]'
# --json switches input + output to JSON (best for methods taking/returning XML)
acc instance soap -s nms:delivery -m BuildPreviewFromId --args '[1234, "<params/>"]' --json

# Run server-side JavaScript (xtk:builder#EvaluateJavaScript). Requires admin rights.
# Use `context` to output results.
acc instance exec -s "context.@result = application.instanceName"
acc instance exec -s "context.@result = getOption('NmsEmail_DefaultFromAddr')"
acc instance exec -f ./Administration/Configuration/JavaScript codes/mynamespace/my-script.js

# Diagnostic report: connection test, server time, active connections and
# instance state (xtk:session#TestCnx/#GetServerTime/#GetCnxInfo,
# nl:monitoring#DumpCurrentInstanceState). Best-effort: exits non-zero if any
# probe fails.
acc instance info --alias staging

Check any IMS token whether it is expired (base64 → JSON; the signature is not verified):

acc auth decode eyJhbG...
acc auth decode eyJhbG... --json | jq .expiry