Quickstart

Sign up, copy your API key, create a one-off task with a webhook URL.

1. Get an API key

Sign up or open API Keys if you already have an account.

2. Connect your LLM provider

Add your Anthropic or OpenAI key in LLM Provider. Model usage is billed by your provider — Meerkat runs tasks using your key.

3. Create a one-off task

curl -X POST https://cloud.meerkatagents.com/api/v1/tasks \
  -H "Authorization: Bearer mk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": {
      "task_type": "one_off",
      "description": "Fetch courier status and report findings",
      "input_params": {
        "courier_tracking_link": "https://..."
      },
      "output_webhook": "https://your-app.com/hook",
      "run_immediately": true
    }
  }'

output_webhook is required. output_format is optional and defaults to default — see Webhooks.

With run_immediately: true (default for one-off tasks), Meerkat runs the task right away and POSTs results to your webhook.

4. Check the run

curl https://cloud.meerkatagents.com/api/v1/tasks/1/runs \
  -H "Authorization: Bearer mk_YOUR_KEY"

Task types → · Full Tasks API →