Xero Projects API – Project, task, time, and project item management.
Base URL: https://api.xero.com/projects.xro/2.0/
Scopes: projects or projects.read
Status flow: INPROGRESS → CLOSED (irreversible) | CANCELLED
Summary
Functions
Creates a project item.
Required: task_id, unit_amount, quantity.
Optional: code, description, date_utc, account_code.
Creates a new project.
Required: name, contact_id. Optional: deadline_utc, estimate_amount, currency_code.
Creates a task. Required: name, charge_type.
For TIME tasks, optionally set rate and estimate_minutes.
Logs a time entry. Required: user_id, task_id, date_utc, duration (minutes).
Optional: description.
Deletes a project item.
Deletes a task (only if no time has been logged against it).
Lists project items (non-time charges: expenses, products).
Lists tasks for a project.
Options: :page, :page_size, :task_ids, :charge_type
charge_type values: "TIME" | "FIXED" | "NON_CHARGEABLE"
Lists time entries. Options: :user_id, :task_id, :invoice_id,
:is_chargeable, :date_after_utc, :date_before_utc, :page, :page_size
Lists users who can be assigned to projects in this organisation.
Functions
Creates a project item.
Required: task_id, unit_amount, quantity.
Optional: code, description, date_utc, account_code.
Creates a new project.
Required: name, contact_id. Optional: deadline_utc, estimate_amount, currency_code.
Creates a task. Required: name, charge_type.
For TIME tasks, optionally set rate and estimate_minutes.
Logs a time entry. Required: user_id, task_id, date_utc, duration (minutes).
Optional: description.
Deletes a project item.
Deletes a task (only if no time has been logged against it).
Lists project items (non-time charges: expenses, products).
Lists tasks for a project.
Options: :page, :page_size, :task_ids, :charge_type
charge_type values: "TIME" | "FIXED" | "NON_CHARGEABLE"
Lists time entries. Options: :user_id, :task_id, :invoice_id,
:is_chargeable, :date_after_utc, :date_before_utc, :page, :page_size
Lists users who can be assigned to projects in this organisation.