---
title: "Create a One-Time Cron"
url: https://docs.catalyst.zoho.com/en/sdk/python/v1/job-scheduling/cron/create-one-time-cron/
description: "This page describes the Python method to create a one-time cron in your project with sample code snippets."
last_updated: 2026-09-08T11:07:33Z
service: Job Scheduling
type: general
related_links:
  - name: "Component Help Documentation"
    url: /en/job-scheduling/help/cron/key-concepts/#schedule-type
  - name: "Java SDK"
    url: /en/sdk/java/v1/job-scheduling/cron/create-one-time-cron/
  - name: "JavaScript SDK Documentation"
    url: /en/sdk/javascript/v1/job-scheduling/cron/create-one-time-cron/
  - name: "REST API Collection"
    url: /en/api/code-reference/job-scheduling/cron/create-cron/create-one-time-cron/#CreateaOne-TimeCron
---

# Create a One-Time Cron

The [Cron](https://docs.catalyst.zoho.com/en/job-scheduling/help/cron/introduction/) component is used to schedule the submission of a [job](https://docs.catalyst.zoho.com/en/job-scheduling/help/job/introduction/) to the [job Pool](https://docs.catalyst.zoho.com/en/job-scheduling/help/jobpool/introduction/). Using the following SDK, you will be able to create a cron that will schedule a job submission only once.

> **Note:** The following SDK is written for a job that will trigger a [Job Function](https://docs.catalyst.zoho.com/en/serverless/help/functions/job-functions/). To make the SDK compatible for the other types, you need to replace the value with proper [**Job Pool ID**](https://docs.catalyst.zoho.com/en/job-scheduling/help/jobpool/key-concepts/#job-pool-id), or **Job Pool Name**, and provide the appropriate **Target Name**, or **Target ID**.

```python
# create function job meta
job_meta = {
    "job_name": "test_job",  # set a name for the job
    "target_type": "Function",  # set the target type as Function for function jobs
    "target_name": "target_function",  # set the target function's name (optional) (either target_id or target_name is mandatory)
    # 'target_id': '123467890', # set the target functions's Id (optional) (either target_id or target_name is mandatory)
    "jobpool_name": "test",  # set the name of the function jobpool (optional) (either jobpool_name or jobpool_id is mandatory)
    # 'jobpool_id': '1234567890' # set the Id of the function jobpool (optional) (either jobpool_name or jobpool_id is mandatory)
    "job_config": {
        "number_of_retries": 2,  # set the number of retries
        "retry_interval": 15 * 60,  # set the retry interval
    },  # set job config - job retries => 2 retries in 15 mins (optional)
    "params": {
        "arg1": "test",
        "arg2": "job",
    },  # set params to be passed to target function (optional)
}
    # create one time cron
one_time_cron = job_scheduling.CRON.create(
    {
        "cron_name": "one_time",  # set a name for the cron (unique)
        "description": "one_time_cron",  # set the cron description (optional)
        "cron_status": True,  # set the cron status as enabled
        "cron_type": "OneTime",  # set the cron type as OneTime
        "cron_detail": {
            "time_of_execution": int(time.time())
            + (60 * 10 * 1000),  # set the execution time as UNIX timestamp
            # 'timezone': 'America/Los_Angeles' # set the timezone (optional)
        },
        "job_meta": job_meta,  # set the function job meta
    }
)
```

> **Note:** We urge you to use this SDK to configure only [Dynamic Crons](https://docs.catalyst.zoho.com/en/job-scheduling/help/implementation/submit-job-dynamic-cron/). Use the *UI Builder* to configure [Pre-defined Crons](https://docs.catalyst.zoho.com/en/job-scheduling/help/implementation/submit-job-predefined-cron/).