Skip to content
Recuro

Quick Start

This guide walks you through creating your first scheduled HTTP job in under 5 minutes.

1. Create an account

Sign up at app.recurohq.com and create your team.

2. Get your API token

Go to Settings → API and generate a token. You’ll use this to authenticate all API requests.

3. Create a cron job

Use the dashboard or the API to create a recurring job.

Via dashboard: Navigate to Crons → New Cron and fill in the URL, method, and cron expression.

Via API:

Terminal window
curl -X POST https://app.recurohq.com/api/crons \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Health Check",
    "url": "https://api.yourapp.com/health",
    "method": "GET",
    "cron_expression": "*/5 * * * *"
  }'

The cron will start firing every 5 minutes immediately.

4. Push a one-off job

To schedule a single HTTP call (e.g. after a user signs up), use the jobs endpoint:

Terminal window
curl -X POST https://app.recurohq.com/api/jobs \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "queue": "notifications",
    "url": "https://api.yourapp.com/notify",
    "payload": { "event": "user_signup" }
  }'

To delay it by 30 minutes, add "delay": 1800.

5. Monitor executions

Go to Crons → [your cron] → Executions or Jobs in the sidebar to see the full history with response times and status codes. Each run shows the request headers, response body, and any error details.

6. (Optional) Connect your AI agent

Recuro has an MCP server so AI agents can manage crons and jobs for you. Add this to your MCP config:

{
  "mcpServers": {
    "recuro": {
      "command": "npx",
      "args": ["-y", "recuro-mcp"],
      "env": {
        "RECURO_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Then ask your agent: “Create a cron that pings https://api.example.com/health every 5 minutes.”

See the MCP Server docs for the full tool reference.

Next steps