Skip to content

Overview

The Truto CLI is the command-line interface for the Truto unified API platform. Use it to manage platform resources (integrations, accounts, sync jobs, webhooks, and more), call unified and proxy APIs against live connections, bulk-export data, and scaffold integrations with AI-assisted builds.

What you can do

Area Examples
Authentication truto login, profiles for staging vs production
Integrations List, create, update; AI-powered integrations build; push configs with apply
Connected accounts truto accounts list, refresh OAuth, mint scoped tokens
Automation Sync jobs, workflows, webhooks, daemon jobs
Data plane truto unified, truto proxy, truto custom, truto batch
Power tools export, diff, jsonata eval, open resources in the dashboard

Before you begin

You need three things before the CLI can talk to Truto:

Requirement What it is How to get it
Truto account Access to the dashboard and your team Sign in or ask your team admin for an invite
API token A secret Bearer credential scoped to one environment Create one in the dashboard — see Creating API tokens
Info

Each API token belongs to a single environment. Commands only see integrations, accounts, and other resources in that environment. Use separate CLI profiles if you work across staging and production.

Quick start

1. Install the CLI

curl -fsSL https://cli.truto.one/install.sh | bash

The installer places truto in ~/.truto/bin. If truto is not found, add that directory to your PATH (the install script usually prints the exact line to run), then open a new terminal tab.

See Installation for version pinning and upgrades.

2. Log in

Interactive — the CLI prompts for profile name, API URL, and token:

truto login

Non-interactive — pass the token you copied from the dashboard:

export TRUTO_API_TOKEN="<paste-your-token-here>"
truto login --token "$TRUTO_API_TOKEN"

Leave the API URL at the default (https://api.truto.one) unless your team uses a custom instance.

Details: Authentication.

3. Verify

truto whoami

You should see your profile, API URL, team name, and the environment your token is scoped to.

4. Explore your environment

# Integrations installed in this environment (not the global catalog)
truto integrations list
 
# API tokens you can inspect (create/delete still requires the dashboard)
truto api-tokens list

Next commands to try:

truto accounts list                    # connected customer accounts
truto integrations list --name hubspot # filter by slug
truto open integrations                # open the dashboard in your browser

For a full product walkthrough (Link, webhooks, first unified call), continue with Getting started.

Documentation map

Topic Page
Install and upgrade Installation
Login, profiles, tokens Authentication
Flags and output formats Global options
Integrations (CRUD, apply, lint) Managing integrations
AI build from docs AI-powered build
Add one method (you supply details) Add method
Accounts, sync jobs, webhooks, etc. Admin resources
Unified, proxy, custom, batch Data plane
Export, diff, JSONata, open Power features
Guided wizard Interactive mode
Full command list Command reference
Cookbook examples Examples
Tip

Coding agents can run truto context for a single-shot reference of every command, flag, and entity. Add --full for the auto-generated command tree.