​
Introduction to A1Cron

A1Cron is A1Base’s powerful cron job management system that enables you to schedule and automate HTTP requests with precision. Whether you need to run daily reports, sync data between systems, or perform regular health checks, A1Cron provides the tools you need to automate these tasks reliably.

​
What is A1Cron?

A1Cron allows you to:

  • Schedule HTTP requests to run at specific times and intervals
  • Monitor execution status and view detailed logs
  • Configure automatic retries for failed requests
  • Receive webhook notifications for job outcomes
  • Organize jobs with tags for easy management

​
Core Concepts

​
Cron Jobs

A cron job is a scheduled task that executes an HTTP request at specified intervals. Each job includes:

  • Endpoint URL: The target URL to call
  • Schedule: When and how often to run
  • HTTP Configuration: Method, headers, and body
  • Retry Settings: How to handle failures
  • Callbacks: Webhooks for success/failure notifications

​
Scheduling Options

Run tasks every N hours. Perfect for:

  • Regular data syncs
  • Cache refreshing
  • Monitoring checks
{
  "repeat_type": "hourly",
  "repeat_every": 2,
  "time": "00:30"
}

​
Timezone Support

All cron jobs run in the timezone you specify. A1Cron supports all standard timezone identifiers:

  • America/New_York
  • Europe/London
  • Asia/Tokyo
  • UTC

Timezone support ensures your jobs run at the correct local time, automatically adjusting for daylight saving time changes.

​
Retry Configuration

Configure how A1Cron handles failed requests:

{
  "max_retries": 3,
  "retry_delay_seconds": 60,
  "timeout_seconds": 30
}
  • max_retries: Number of retry attempts (0-10)
  • retry_delay_seconds: Wait time between retries
  • timeout_seconds: Maximum time to wait for response

​
Webhook Callbacks

Get notified about job execution results:

{
  "success_url": "https://your-app.com/webhooks/cron-success",
  "failure_url": "https://your-app.com/webhooks/cron-failure"
}

Callbacks receive POST requests with execution details:

{
  "cron_job_id": "550e8400-e29b-41d4-a716-446655440000",
  "execution_id": "exe_123456",
  "status": "success",
  "executed_at": "2024-01-25T14:00:00Z",
  "response_code": 200,
  "response_time_ms": 245
}

​
Authentication

All API requests require authentication headers:

X-API-Key: your-api-key
X-API-Secret: your-api-secret

Get your credentials from the A1Base Dashboard.

​
Base URL

All A1Cron endpoints use the base URL:

https://api.a1base.com

​
Rate Limits

  • API Requests: 1000 requests per hour
  • Cron Jobs: Maximum 100 active jobs per account
  • Execution Frequency: Minimum interval of 1 hour for hourly jobs

​
Best Practices

​
Next Steps

Quick Start

Create your first cron job

API Reference

Explore the complete API