---
title: "Schedule flat-rate payments for a cohort"
method: POST
path: "/api/cohorts/{cohortId}/billcom/payments/schedule"
tags: ["Cohort Payments"]
---

# Schedule flat-rate payments for a cohort

`POST /api/cohorts/{cohortId}/billcom/payments/schedule`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/api/cohorts/{cohortId}/billcom/payments/schedule`
- Auth: none declared

Creates bills and schedules payments in Bill.com for all confirmed coach compensation. Returns a job ID for progress tracking.

## Path parameters

- `cohortId` string, uuid, required

## Response `201`

Payment scheduling job created

- object
  - `job_id` string, uuid
  - `total_payments` integer

## Other responses

- `400`: Unmapped coaches or no confirmed compensation
- `401`: Unauthorized
- `409`: Payments already scheduled

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)