Scheduler Zero
REST APIAPI referenceLeads

Upload raw row data into a lead list

Each row is a flat object of string keys to string values (e.g. a parsed CSV row). Requires the `lead:import` permission.

POST
/leads/upload

Each row is a flat object of string keys to string values (e.g. a parsed CSV row). Requires the lead:import permission.

Authorization

ApiKeyAuth
x-api-key<token>

API key created under Settings → API Keys. Scoped to a single workspace.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/leads/upload" \  -H "Content-Type: application/json" \  -d '{    "leadListId": "cf1ea3ab-6c18-4de4-81e1-803f9fe6e6ec",    "data": [      {        "property1": "string",        "property2": "string"      }    ]  }'
{  "uploaded": 0}

List the leads in a lead list GET

Requires the `lead:read` and `leadList:read` permissions.

Get the queryable SQL schema GET

Self-documentation for the SQL query interface: every view (table) you can `SELECT` from via `POST /v1/sql/query`, its columns (name, type, description), and the interface's limits. Call this before writing a query — this is a curated set of tenant-scoped views, not the full production schema, and `runSqlQuery` only accepts relations listed here. Requires the `sql:query` permission and workspace enrollment in the SQL query private alpha (`403` otherwise, contact us to request access).