---
title: "Create scheduled delivery"
method: POST
path: "/v1/scheduled-deliveries"
tags: ["Scheduled Deliveries"]
---

# Create scheduled delivery

`POST /v1/scheduled-deliveries`

Create a scheduled price delivery

## Request body

- object
  - `scheduled_delivery` object
    - `name` string
    - `commodity_codes` string[], required
    - `cadence` 'daily' | 'weekdays' | 'weekly'
    - `weekday` integer — 1 = Monday … 7 = Sunday; used when cadence is weekly
    - `delivery_time` string — HH:MM, 24-hour, in time_zone
    - `time_zone` string
    - `recipient_email` string, email
    - `enabled` boolean

## Response `201`

Scheduled delivery created

## Other responses

- `401` — Unauthorized — missing or invalid API key
- `422` — Validation failed or plan limit reached

## Changes

- **2026-09-26** `ee078187e2f6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/changes/v1/scheduled-deliveries/post.md)

---

[API](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1.md) · [All operations](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/revisions/ee078187e2f6?raw)