---
title: "Create a project billing schedule item"
method: POST
path: "/project-billing-schedule-items"
tags: ["Project Billing Schedule Items"]
---

# Create a project billing schedule item

`POST /project-billing-schedule-items`

## Request

- Base URL: `https://www.ruddr.io/api/workspace`
- URL: `https://www.ruddr.io/api/workspace/project-billing-schedule-items`
- Auth: HTTP bearer

## Request body

- object
  - `typeId` 'custom' | 'recurring': The type of billing schedule item. Identifies whether the item is one-off (`"custom"`, the default) or recurring (`"recurring"`).
  - `date` string, date, required: The date of the billing schedule item. Must be in the form YYYY-MM-DD.
  - `quantity` number, nullable: The quantity for calculating the `fee`. Required when `rate` is provided.
  - `rate` number, nullable: The rate for calculating the `fee`. Required when `quantity` is provided.
  - `fee` number: The total amount for the billing schedule item. Required when `quantity` and `rate` are not provided.
  - `name` string, required: The name of the billing schedule item (max 255 chars).
  - `projectId` string, required: The project ID (`uuid`) for this billing schedule item. Must be a `fixed` or `fixed_recurring` billing type project.
  - `invoiceItemId` string, required: The invoice item ID (`uuid`) for this billing schedule item.

## Response `200`

200

- ProjectBillingScheduleItem
  - `id` string: The unique identifier for the object.
  - `typeId` 'custom' | 'recurring': The type of billing schedule item. Identifies whether the item is one-off (`"custom"`, the default) or recurring (`"recurring"`).
  - `date` string, date: The date of the billing schedule item. Will be in the form YYYY-MM-DD.
  - `quantity` number, nullable: The quantity used to calculate the `fee`.
  - `rate` number, nullable: The rate used to calculate the `fee`.
  - `fee` number: The total amount for the billing schedule item.
  - `name` string: The name of the billing schedule item.
  - `createdAt` string, date-time: The timestamp when the object was created.
  - `project` object: The project this billing schedule item belongs to.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the project.
    - `client` object: The client associated with the project.
      - `id` string: The unique identifier for the object.
      - `name` string: The name of the client.
  - `invoiceItem` object: The invoice item associated with this billing schedule item.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the invoice item.
  - `invoiced` boolean: Whether the billing schedule item has been invoiced.

## Other responses

- `400`: 400

---

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