Quickstart

Open the dashboard

After signing in, you'll land on the dashboard. Click Create Workflow (or the + button).

Name your workflow

Give it a descriptive name like "Lead Classifier" or "Content Generator". You can also add a description.

Open the editor

Your new workflow opens in the visual editor with a default Manual trigger node on the canvas.

Click the + button

Click the + node below the trigger to add your first action. A panel opens showing all available actions grouped by integration.

Choose an action

For this quickstart, pick AI Gateway → Generate Text. This uses an AI model to generate text from a prompt.

Other popular choices:

• Skytells → Create Prediction — Run any Skytells model for images, video, or text
• Slack → Send Message — Post to a Slack channel
• Resend → Send Email — Send a transactional email
• Perplexity → Search Web — Run a web search query

Configure the action

Click the new action node to open its configuration panel on the right side. Fill in the required fields:

• Model: Select an AI model (e.g., claude-sonnet-4-20250514)
• Prompt: Enter your prompt text (e.g., Summarize the following: {{@trigger.input}})

Fields that support template variables show a {{ }} icon. You can reference output from any previous step — see Variables & Conditions.

Connect an integration

If the action needs credentials (e.g., an API key), you'll see an Integration dropdown. If you haven't set one up yet:

1. Open your user menu → Connections
2. Click Add Connection
3. Select the provider, enter your API key, and save
4. Back in the action config, select your new connection

See Integrations for details.

Click Run

In the toolbar at the top, click the Run (play) button. The workflow executes immediately using the Manual trigger.

Watch execution status

Each node shows a status badge as it runs:

• Running (blue spinner)
• Success (green check)
• Error (red indicator)

View execution logs

Open the Runs panel (sidebar) to see execution history. Click any run to inspect per-step inputs, outputs, and errors.

See Execution & Logs for the full status model.

Change trigger type

Click the trigger node and change the trigger type from Manual to Webhook.

Optionally define a webhook schema to describe the expected request body.

Create an Orchestrator API key

Open your user menu → API Keys → Create Key. Name it (e.g., "production"). Copy the key immediately — it's shown only once.

The key format is wfb_<random>. This is different from your Skytells API key.

Call the webhook

curl -X POST "https://orchestrator.skytells.ai/api/workflows/<workflowId>/webhook" \
  -H "Authorization: Bearer wfb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello from my app"}'

Response:

{
  "executionId": "exec_abc123",
  "status": "running"
}

See Webhooks for the full reference.