---
title: "Scheduled fill: pull rows from your endpoint, deliver by webhook (or poll the jobs). Or { workflow_id }: run a whole workflow over its own saved source"
method: POST
path: "/api/v1/schedules"
tags: ["Automation"]
---

# Scheduled fill: pull rows from your endpoint, deliver by webhook (or poll the jobs). Or { workflow_id }: run a whole workflow over its own saved source

`POST /api/v1/schedules`

## Request

- Base URL: `https://philforms.com`
- URL: `https://philforms.com/api/v1/schedules`
- Auth: HTTP bearer

## Request body

- object
  - `form_id` string, required
  - `workflow_id` string: Run this workflow (its source and every form) instead of one form
  - `name` string
  - `daily_at` string: HH:MM Asia/Manila
  - `interval_minute` integer
  - `source` object, required: { type: "url", url, header? } | { type: "static", data }
  - `webhook_url` string

## Response `201`

{ schedule, webhook_secret }

## Other responses

- `400`: Bad timing, source or URL
- `404`: Unknown form

---

[API](https://skmtc.dev/philforms/apis/philforms-api.md) · [All operations](https://skmtc.dev/philforms/apis/philforms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/philforms/apis/philforms-api/revisions/a43bf313729c?raw)