API ReferenceActions

Create Action

POST
/actions

Create a saved action from a catalog action key: its task, scope, destinations, and what runs it: schedule.frequency (daily, weekly, monthly or quarterly) for a schedule and triggers for events or signals, with a cooldown. An AI action with triggers runs itself on each match and spends credits (at most once per company per cooldown window). Destinations are plan-gated at save. Organization-wide; requires owner/admin. Returns the created action.

Authorization

AuthorizationBearer <token>

Organization API Token (prefixed sk_) sent as Authorization: Bearer sk_.... Create one in Settings and grant it scopes. Server-side only.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X POST "https://example.com/actions" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "action_key": "company.lookup"  }'
Empty