Skip to main content

Overview

The Script API lets you:
  • Create and manage workflows programmatically
  • Run workflows with custom inputs
  • Batch process hundreds of items
  • Monitor execution status and results
  • Modify steps dynamically

Base URL

https://script.so/api/v1

Authentication

All endpoints require a Bearer token. Get your API key from Settings → API.
curl https://script.so/api/v1/workflows \
  -H "Authorization: Bearer YOUR_API_KEY"

Quick Start

1. List your workflows

curl https://script.so/api/v1/workflows \
  -H "Authorization: Bearer YOUR_API_KEY"

2. Run a workflow

curl -X POST https://script.so/api/v1/workflows/{workflow_id}/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inputs": {"email": "john@example.com"}}'

3. Check execution status

curl https://script.so/api/v1/executions/{execution_id} \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Format

All responses are JSON:
{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123"
  }
}

Rate Limits

PlanRequests/minuteConcurrent executions
Free605
Pro30025
EnterpriseCustomCustom

Errors

CodeDescription
400Bad request — check your parameters
401Unauthorized — invalid or missing API key
404Not found — resource doesn’t exist
429Rate limited — slow down
500Server error — try again later

Endpoints