Skip to main content
POST
Create a project billing schedule item
Scheduled invoicing for a fixed fee project. This is only available for projects that have a billing type of “fixed” or “fixed_recurring”. The legacy /project-invoice-milestones path remains available as an alias for this endpoint.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
date
string<date>
required

The date of the billing schedule item. Must be in the form YYYY-MM-DD.

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.

typeId
enum<string>

The type of billing schedule item. Identifies whether the item is one-off ("custom", the default) or recurring ("recurring").

Available options:
custom,
recurring
quantity
number | null

The quantity for calculating the fee. Required when rate is provided.

rate
number | null

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.

Response

200

id
string

The unique identifier for the object.

typeId
enum<string>

The type of billing schedule item. Identifies whether the item is one-off ("custom", the default) or recurring ("recurring").

Available options:
custom,
recurring
date
string<date>

The date of the billing schedule item. Will be in the form YYYY-MM-DD.

quantity
number | null

The quantity used to calculate the fee.

rate
number | null

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.

invoiceItem
object

The invoice item associated with this billing schedule item.

invoiced
boolean

Whether the billing schedule item has been invoiced.