MOCO
App · 20 actions
Work with your MOCO agency account: log, list and change time entries, manage projects and their tasks, customers and contacts, and list invoices. Start workflows on new time entries, projects, companies and invoices.
Actions
| Action | What it does |
|---|---|
| Add task to project | Add a task (a service, such as Design) to a project, so time can be logged on it. |
| Create company | Create a customer, supplier or organization with its contact details. |
| Create contact | Add a contact person, optionally at a company, with their job and work details. |
| Create project | Create a project for a customer, billed by the hour or at a fixed price, with its leader, dates, budget and rate. |
| Delete company | Delete a company. |
| Delete contact | Delete a contact person. |
| Delete project | Delete a project. |
| Delete time entry | Delete a time entry. |
| Get project | Get one project with its customer, leader, dates, budget, rate and tasks. |
| List companies | List customers, suppliers and organizations, by type, tags or a search. |
| List contacts | List contact people, searched by name, email or company, or by tags. |
| List invoices | List invoices with their number, totals and status, filtered by status, invoice date, customer or project. |
| List project tasks | List a project's tasks (its services), which time is logged against. |
| List projects | List projects, filtered by customer, project leader, tags or a search of name, number and customer. |
| List staff | List the people in your MOCO account, with their ids for the project leader and person fields. |
| List time entries | List logged time, filtered by dates, project, task, person, customer or billing state, with the hours on the page added up. |
| Log time | Log time on a project's task for a day, as the person whose API key is connected. |
| Update company | Change a company's name, contact details, address, VAT ID, notes, responsible person or tags. |
| Update project | Change a project's name, leader, customer, dates, budget, rate, notes or tags. |
| Update time entry | Change a time entry's day, project, task, hours, description or billable setting. |
Add task to project
Add a task (a service, such as Design) to a project, so time can be logged on it.
Inputs
- Project
project_idtextRequired - The project. Pick one, or give its id.
- Name
nametextRequired - The task's name.
- Billable
billabletext - Whether time on the task can be billed. Defaults to yes.One of:
yes,no. - Rate per hour
hourly_ratenumber - The task's hourly rate.At least 0.
- Budget
budgetnumber - The task's budget.At least 0.
- Description
descriptiontext - What the task covers.
Outputs
project_idnumber- The project
taskobject- The new task
Example output
{
"project_id": 1185211,
"task": {
"active": true,
"billable": true,
"budget": null,
"created_at": "2026-10-01T09:00:00Z",
"description": null,
"hourly_rate": 120,
"id": 889229,
"name": "Design",
"updated_at": "2026-10-01T09:00:00Z"
}
}Create company
Create a customer, supplier or organization with its contact details. A customer needs a currency.
Inputs
- Name
nametextRequired - The company's name.
- Type
company_typetext - Customer, supplier or other organization. Defaults to customer.One of:
customer,supplier,organization. Default:customer. - Currency
currencytext - The three-letter currency a customer is billed in, such as EUR. Needed for a customer.
- Customer number
identifiertext - The customer's number, such as K-123, when your account numbers them by hand.
- Email
emailtext - The company's email address.
- Phone
phonetext - The company's phone number.
- Website
websitetext - The company's website.
- Address
addresstext - The postal address, one line per row.
- Country
country_codetext - The two-letter country code, such as DE.
- VAT ID
vat_identifiertext - The company's VAT identification number.
- Notes
infotext - Notes on the company.
- Responsible person
moco_user_idtext - Who looks after the company.
- Tags
tagslist - Tags to set, such as Print or Digital.
Outputs
companyobject- The company
Example output
{
"company": {
"active": true,
"address": "Acme Ltd\nExample Street 1\n10115 Berlin",
"archived_on": null,
"country_code": "DE",
"created_at": "2026-09-01T09:00:00Z",
"currency": "EUR",
"custom_properties": {},
"email": "billing@acme.example.com",
"id": 760253573,
"identifier": "K-101",
"info": null,
"name": "Acme Ltd",
"phone": "+49 30 123 45 67",
"tags": [
"Retail"
],
"type": "customer",
"updated_at": "2026-10-01T09:00:00Z",
"user": {
"firstname": "Anna",
"id": 933590696,
"lastname": "Muster"
},
"vat_identifier": "DE123456789",
"website": "https://acme.example.com"
}
}Create contact
Add a contact person, optionally at a company, with their job and work details.
Inputs
- Last name
lastnametextRequired - The person's last name.
- First name
firstnametext - The person's first name.
- Gender
gendertext - Used for the salutation in MOCO's letters. Defaults to not stated.One of:
U(Not stated),F(Female),M(Male). Default:U. - Company
company_idtext - The company the person works at.
- Job title
job_positiontext - The person's job, such as Account Manager.
- Title
titletext - An academic title, such as Dr.
- Work email
work_emailtext - The person's work email address.
- Work phone
work_phonetext - The person's work phone number.
- Mobile phone
mobile_phonetext - The person's mobile number.
- Notes
infotext - Notes on the person.
- Tags
tagslist - Tags to set, such as Print or Digital.
Outputs
contactobject- The contact
Example output
{
"contact": {
"company": {
"id": 760253573,
"name": "Acme Ltd",
"type": "customer"
},
"created_at": "2026-10-05T09:00:00Z",
"custom_properties": {},
"firstname": "Petra",
"gender": "F",
"id": 123498,
"info": null,
"job_position": "Marketing Lead",
"lastname": "Muster",
"mobile_phone": null,
"tags": [],
"title": null,
"updated_at": "2026-10-05T09:00:00Z",
"user": {
"firstname": "Anna",
"id": 933590696,
"lastname": "Muster"
},
"work_address": null,
"work_email": "petra@acme.example.com",
"work_phone": "+49 30 123 45 68"
}
}Create project
Create a project for a customer, billed by the hour or at a fixed price, with its leader, dates, budget and rate.
Inputs
- Name
nametextRequired - The project's name.
- Currency
currencytextRequired - The three-letter currency it is billed in, such as EUR. It cannot be changed later.
- Project leader
leader_idtextRequired - Who leads the project.
- Company
company_idtextRequired - The customer the project is for.
- Project number
identifiertext - The project's number, such as P-123. Needed only when your account numbers projects by hand.
- Start date
start_datedate - When the project starts.
- Finish date
finish_datedate - When the project ends.
- Hourly rate
billing_varianttext - How hourly rates are set. Defaults to one rate for the project.One of:
project(One rate for the project),task(A rate per task),user(A rate per person). - Rate per hour
hourly_ratenumber - The hourly rate, in the project's currency.At least 0.
- Budget
budgetnumber - The budget, in the project's currency.At least 0.
- Notes
infotext - Internal notes on the project.
- Tags
tagslist - Tags to set, such as Print or Digital.
- Fixed price
fixed_pricetrue/false - Bill the project at a fixed price rather than by the hour.Default:
false.
Outputs
projectobject- The project
Example output
{
"project": {
"active": true,
"archived_on": null,
"billable": true,
"billing_variant": "project",
"budget": 20000,
"co_leader": null,
"color": "#38b5eb",
"created_at": "2026-10-01T09:00:00Z",
"currency": "EUR",
"custom_properties": {},
"customer": {
"id": 760253573,
"name": "Acme Ltd"
},
"finish_date": "2026-12-31",
"fixed_price": false,
"hourly_rate": 120,
"id": 1185211,
"identifier": "P-123",
"info": null,
"leader": {
"firstname": "Anna",
"id": 933590696,
"lastname": "Muster"
},
"name": "Website relaunch",
"retainer": false,
"start_date": "2026-10-01",
"tags": [
"Digital"
],
"tasks": [
{
"active": true,
"billable": true,
"budget": null,
"created_at": "2026-10-01T09:00:00Z",
"description": null,
"hourly_rate": 120,
"id": 889229,
"name": "Design",
"updated_at": "2026-10-01T09:00:00Z"
}
],
"updated_at": "2026-10-02T09:00:00Z"
}
}Delete company
Delete a company. MOCO only deletes one with nothing such as a project or invoice attached.
Inputs
- Company
company_idtextRequired - The company. Pick one, or give its id.
Outputs
company_idnumber- The company deleted
deletedtrue/false- Always true once deleted
Example output
{
"company_id": 760253573,
"deleted": true
}Delete contact
Delete a contact person.
Inputs
- Contact ID
contact_idtextRequired - The contact's id, from 'List contacts' or an earlier step.
Outputs
contact_idnumber- The contact deleted
deletedtrue/false- Always true once deleted
Example output
{
"contact_id": 123498,
"deleted": true
}Delete project
Delete a project. MOCO only deletes one with no time entries, invoices, offers or expenses on it.
Inputs
- Project
project_idtextRequired - The project. Pick one, or give its id.
Outputs
deletedtrue/false- Always true once deleted
project_idnumber- The project deleted
Example output
{
"deleted": true,
"project_id": 1185211
}Delete time entry
Delete a time entry. MOCO keeps entries that are billed or locked.
Inputs
- Time entry ID
activity_idtextRequired - The time entry's id, from 'List time entries' or an earlier step.
Outputs
activity_idnumber- The time entry deleted
deletedtrue/false- Always true once deleted
Example output
{
"activity_id": 988913743,
"deleted": true
}Get project
Get one project with its customer, leader, dates, budget, rate and tasks.
Inputs
- Project
project_idtextRequired - The project. Pick one, or give its id.
Outputs
projectobject- The project
Example output
{
"project": {
"active": true,
"archived_on": null,
"billable": true,
"billing_variant": "project",
"budget": 20000,
"co_leader": null,
"color": "#38b5eb",
"created_at": "2026-10-01T09:00:00Z",
"currency": "EUR",
"custom_properties": {},
"customer": {
"id": 760253573,
"name": "Acme Ltd"
},
"finish_date": "2026-12-31",
"fixed_price": false,
"hourly_rate": 120,
"id": 1185211,
"identifier": "P-123",
"info": null,
"leader": {
"firstname": "Anna",
"id": 933590696,
"lastname": "Muster"
},
"name": "Website relaunch",
"retainer": false,
"start_date": "2026-10-01",
"tags": [
"Digital"
],
"tasks": [
{
"active": true,
"billable": true,
"budget": null,
"created_at": "2026-10-01T09:00:00Z",
"description": null,
"hourly_rate": 120,
"id": 889229,
"name": "Design",
"updated_at": "2026-10-01T09:00:00Z"
}
],
"updated_at": "2026-10-02T09:00:00Z"
}
}List companies
List customers, suppliers and organizations, by type, tags or a search. Gets one page of up to 100; to see more, run it again with the next page.
Inputs
- Type
company_typetext - Only companies of this type.One of:
customer,supplier,organization. - Search
termtext - Words to find in the name.
- Tags
tagslist - Only records with these tags.
- Include archived
include_archivedtrue/false - Also list archived ones.Default:
false. - Page
pagenumber - Which page to get, from 1. Use it when the last run said there are more.At least 1.
- Page size
per_pagenumber - How many to return, 1 to 100. MOCO's default is 100.From 1 to 100.
Outputs
companieslist- The companies
countnumber- How many on this page
has_moretrue/false- True when there is a next page: run again with the next page
pagenumber- The page number, from 1
totalnumber- How many match, on every page
Example output
{
"companies": [
{
"active": true,
"address": "Acme Ltd\nExample Street 1\n10115 Berlin",
"archived_on": null,
"country_code": "DE",
"created_at": "2026-09-01T09:00:00Z",
"currency": "EUR",
"custom_properties": {},
"email": "billing@acme.example.com",
"id": 760253573,
"identifier": "K-101",
"info": null,
"name": "Acme Ltd",
"phone": "+49 30 123 45 67",
"tags": [
"Retail"
],
"type": "customer",
"updated_at": "2026-10-01T09:00:00Z",
"user": {
"firstname": "Anna",
"id": 933590696,
"lastname": "Muster"
},
"vat_identifier": "DE123456789",
"website": "https://acme.example.com"
}
],
"count": 1,
"has_more": false,
"page": 1,
"total": 1
}List contacts
List contact people, searched by name, email or company, or by tags. Gets one page of up to 100; to see more, run it again with the next page.
Inputs
- Search
termtext - Words to find in the name, email or company.
- Tags
tagslist - Only records with these tags.
- Page
pagenumber - Which page to get, from 1. Use it when the last run said there are more.At least 1.
- Page size
per_pagenumber - How many to return, 1 to 100. MOCO's default is 100.From 1 to 100.
Outputs
contactslist- The contacts
countnumber- How many on this page
has_moretrue/false- True when there is a next page: run again with the next page
pagenumber- The page number, from 1
totalnumber- How many match, on every page
Example output
{
"contacts": [
{
"company": {
"id": 760253573,
"name": "Acme Ltd",
"type": "customer"
},
"created_at": "2026-10-05T09:00:00Z",
"custom_properties": {},
"firstname": "Petra",
"gender": "F",
"id": 123498,
"info": null,
"job_position": "Marketing Lead",
"lastname": "Muster",
"mobile_phone": null,
"tags": [],
"title": null,
"updated_at": "2026-10-05T09:00:00Z",
"user": {
"firstname": "Anna",
"id": 933590696,
"lastname": "Muster"
},
"work_address": null,
"work_email": "petra@acme.example.com",
"work_phone": "+49 30 123 45 68"
}
],
"count": 1,
"has_more": false,
"page": 1,
"total": 1
}List invoices
List invoices with their number, totals and status, filtered by status, invoice date, customer or project. Gets one page of up to 100; to see more, run it again with the next page.
Inputs
- Status
statuslist - Only invoices in these states. Leave empty for all but disregarded ones.One or more of:
draft,created,sent,partially_paid(Partially paid),paid,overdue,ignored,disregarded. - Dated from
date_fromdate - Only invoices dated on or after this day.
- Dated to
date_todate - Only invoices dated on or before this day.
- Company
company_idtext - Only this customer's invoices.
- Project
project_idtext - Only this project's invoices.
- Search
termtext - Words to find in the invoice.
- Page
pagenumber - Which page to get, from 1. Use it when the last run said there are more.At least 1.
- Page size
per_pagenumber - How many to return, 1 to 100. MOCO's default is 100.From 1 to 100.
Outputs
countnumber- How many on this page
has_moretrue/false- True when there is a next page: run again with the next page
invoiceslist- The invoices
pagenumber- The page number, from 1
totalnumber- How many match, on every page
Example output
{
"count": 1,
"has_more": false,
"invoices": [
{
"created_at": "2026-11-01T09:00:00Z",
"currency": "EUR",
"custom_properties": {},
"customer_id": 760253573,
"date": "2026-11-01",
"due_date": "2026-11-15",
"gross_total": 7140,
"id": 9876543,
"identifier": "R2611-001",
"locked": true,
"net_total": 6000,
"project_id": 1185211,
"service_period_from": "2026-10-01",
"service_period_to": "2026-10-31",
"status": "sent",
"tags": [],
"tax": 19,
"title": "Invoice: Website relaunch",
"updated_at": "2026-11-01T09:05:00Z",
"user": {
"firstname": "Anna",
"id": 933590696,
"lastname": "Muster"
}
}
],
"page": 1,
"total": 1
}List project tasks
List a project's tasks (its services), which time is logged against.
Inputs
- Project
project_idtextRequired - The project. Pick one, or give its id.
- Page
pagenumber - Which page to get, from 1. Use it when the last run said there are more.At least 1.
- Page size
per_pagenumber - How many to return, 1 to 100. MOCO's default is 100.From 1 to 100.
Outputs
countnumber- How many on this page
has_moretrue/false- True when there is a next page: run again with the next page
pagenumber- The page number, from 1
project_idnumber- The project
taskslist- The project's tasks
totalnumber- How many match, on every page
Example output
{
"count": 1,
"has_more": false,
"page": 1,
"project_id": 1185211,
"tasks": [
{
"active": true,
"billable": true,
"budget": null,
"created_at": "2026-10-01T09:00:00Z",
"description": null,
"hourly_rate": 120,
"id": 889229,
"name": "Design",
"updated_at": "2026-10-01T09:00:00Z"
}
],
"total": 1
}List projects
List projects, filtered by customer, project leader, tags or a search of name, number and customer. Gets one page of up to 100; to see more, run it again with the next page.
Inputs
- Company
company_idtext - Only this customer's projects.
- Project leader
leader_idtext - Only projects this person leads.
- Search
termtext - Words to find in the name, number or customer.
- Tags
tagslist - Only records with these tags.
- Include archived
include_archivedtrue/false - Also list archived ones.Default:
false. - Page
pagenumber - Which page to get, from 1. Use it when the last run said there are more.At least 1.
- Page size
per_pagenumber - How many to return, 1 to 100. MOCO's default is 100.From 1 to 100.
Outputs
countnumber- How many on this page
has_moretrue/false- True when there is a next page: run again with the next page
pagenumber- The page number, from 1
projectslist- The projects
totalnumber- How many match, on every page
Example output
{
"count": 1,
"has_more": false,
"page": 1,
"projects": [
{
"active": true,
"archived_on": null,
"billable": true,
"billing_variant": "project",
"budget": 20000,
"co_leader": null,
"color": "#38b5eb",
"created_at": "2026-10-01T09:00:00Z",
"currency": "EUR",
"custom_properties": {},
"customer": {
"id": 760253573,
"name": "Acme Ltd"
},
"finish_date": "2026-12-31",
"fixed_price": false,
"hourly_rate": 120,
"id": 1185211,
"identifier": "P-123",
"info": null,
"leader": {
"firstname": "Anna",
"id": 933590696,
"lastname": "Muster"
},
"name": "Website relaunch",
"retainer": false,
"start_date": "2026-10-01",
"tags": [
"Digital"
],
"tasks": [
{
"active": true,
"billable": true,
"budget": null,
"created_at": "2026-10-01T09:00:00Z",
"description": null,
"hourly_rate": 120,
"id": 889229,
"name": "Design",
"updated_at": "2026-10-01T09:00:00Z"
}
],
"updated_at": "2026-10-02T09:00:00Z"
}
],
"total": 1
}List staff
List the people in your MOCO account, with their ids for the project leader and person fields. Gets one page of up to 100; to see more, run it again with the next page.
Inputs
- Include archived
include_archivedtrue/false - Also list archived ones.Default:
false. - Email
emailtext - Only the person with this exact email address.
- Page
pagenumber - Which page to get, from 1. Use it when the last run said there are more.At least 1.
- Page size
per_pagenumber - How many to return, 1 to 100. MOCO's default is 100.From 1 to 100.
Outputs
countnumber- How many on this page
has_moretrue/false- True when there is a next page: run again with the next page
pagenumber- The page number, from 1
totalnumber- How many match, on every page
userslist- The people
Example output
{
"count": 1,
"has_more": false,
"page": 1,
"total": 1,
"users": [
{
"active": true,
"created_at": "2026-01-10T09:00:00Z",
"custom_properties": {},
"email": "anna@example.com",
"extern": false,
"firstname": "Anna",
"id": 933590696,
"lastname": "Muster",
"mobile_phone": null,
"role": {
"id": 1,
"name": "Staff"
},
"tags": [],
"unit": {
"id": 909,
"name": "Design"
},
"updated_at": "2026-10-01T09:00:00Z",
"work_phone": "+49 30 123 45 67"
}
]
}List time entries
List logged time, filtered by dates, project, task, person, customer or billing state, with the hours on the page added up. Gets one page of up to 100; to see more, run it again with the next page.
Inputs
- From
from_datedate - Only entries on or after this day.
- To
to_datedate - Only entries on or before this day.
- Project
project_idtext - Only entries on this project.
- Task
task_idtext - Only entries on this task of the project.
- Person
moco_user_idtext - Only this person's entries.
- Company
company_idtext - Only entries for this customer.
- Billable
billabletext - Only billable, or only non-billable, entries.One of:
yes,no. - Billed
billedtext - Only billed, or only not yet billed, entries.One of:
yes,no. - Search
termtext - Words to find in the description or tag.
- Page
pagenumber - Which page to get, from 1. Use it when the last run said there are more.At least 1.
- Page size
per_pagenumber - How many to return, 1 to 100. MOCO's default is 100.From 1 to 100.
Outputs
activitieslist- The time entries
countnumber- How many on this page
has_moretrue/false- True when there is a next page: run again with the next page
pagenumber- The page number, from 1
totalnumber- How many match, on every page
total_hoursnumber- The hours on this page added up
Example output
{
"activities": [
{
"billable": true,
"billed": false,
"created_at": "2026-11-10T16:00:00Z",
"customer": {
"id": 760253573,
"name": "Acme Ltd"
},
"date": "2026-11-10",
"description": "Homepage layout",
"hourly_rate": 120,
"hours": 1.5,
"id": 988913743,
"invoice_id": null,
"project": {
"billable": true,
"id": 1185211,
"identifier": "P-123",
"name": "Website relaunch"
},
"remote_id": null,
"remote_service": null,
"remote_url": null,
"seconds": 5400,
"tag": "",
"task": {
"billable": true,
"id": 889229,
"name": "Design"
},
"timer_started_at": null,
"updated_at": "2026-11-10T16:00:00Z",
"user": {
"firstname": "Anna",
"id": 933590696,
"lastname": "Muster"
},
"worked_seconds": 5400
}
],
"count": 1,
"has_more": false,
"page": 1,
"total": 1,
"total_hours": 1.5
}Log time
Log time on a project's task for a day, as the person whose API key is connected.
Inputs
- Date
datedateRequired - The day the work was done.
- Project
project_idtextRequired - The project the time is for.
- Task
task_idtextRequired - The project's task (service) the time is for.
- Hours
hoursnumber - Time spent, in hours, such as 1.5 for an hour and a half.From 0 to 24.
- Description
descriptiontext - What the time was spent on.
- Billable
billabletext - Whether the time can be billed. Leave empty for the project's default.One of:
yes,no. - Tag
tagtext - A label of your own for the entry, such as RMT-123.
Outputs
activityobject- The time entry
Example output
{
"activity": {
"billable": true,
"billed": false,
"created_at": "2026-11-10T16:00:00Z",
"customer": {
"id": 760253573,
"name": "Acme Ltd"
},
"date": "2026-11-10",
"description": "Homepage layout",
"hourly_rate": 120,
"hours": 1.5,
"id": 988913743,
"invoice_id": null,
"project": {
"billable": true,
"id": 1185211,
"identifier": "P-123",
"name": "Website relaunch"
},
"remote_id": null,
"remote_service": null,
"remote_url": null,
"seconds": 5400,
"tag": "",
"task": {
"billable": true,
"id": 889229,
"name": "Design"
},
"timer_started_at": null,
"updated_at": "2026-11-10T16:00:00Z",
"user": {
"firstname": "Anna",
"id": 933590696,
"lastname": "Muster"
},
"worked_seconds": 5400
}
}Update company
Change a company's name, contact details, address, VAT ID, notes, responsible person or tags. Only the fields given change.
Inputs
- Company
company_idtextRequired - The company. Pick one, or give its id.
- Name
nametext - A new name. Leave empty to keep it.
- Currency
currencytext - A new currency code. Leave empty to keep it.
- Customer number
identifiertext - The customer's number, such as K-123, when your account numbers them by hand. Leave empty to keep it.
- Email
emailtext - The company's email address. Leave empty to keep it.
- Phone
phonetext - The company's phone number. Leave empty to keep it.
- Website
websitetext - The company's website. Leave empty to keep it.
- Address
addresstext - The postal address, one line per row. Leave empty to keep it.
- Country
country_codetext - The two-letter country code, such as DE. Leave empty to keep it.
- VAT ID
vat_identifiertext - The company's VAT identification number. Leave empty to keep it.
- Notes
infotext - Notes on the company. Leave empty to keep it.
- Responsible person
moco_user_idtext - Who looks after the company. Leave empty to keep it.
- Tags
tagslist - Tags to set, such as Print or Digital.
Outputs
companyobject- The company
Example output
{
"company": {
"active": true,
"address": "Acme Ltd\nExample Street 1\n10115 Berlin",
"archived_on": null,
"country_code": "DE",
"created_at": "2026-09-01T09:00:00Z",
"currency": "EUR",
"custom_properties": {},
"email": "billing@acme.example.com",
"id": 760253573,
"identifier": "K-101",
"info": null,
"name": "Acme Ltd",
"phone": "+49 30 123 45 67",
"tags": [
"Retail"
],
"type": "customer",
"updated_at": "2026-10-01T09:00:00Z",
"user": {
"firstname": "Anna",
"id": 933590696,
"lastname": "Muster"
},
"vat_identifier": "DE123456789",
"website": "https://acme.example.com"
}
}Update project
Change a project's name, leader, customer, dates, budget, rate, notes or tags. Only the fields given change; the currency can't be changed.
Inputs
- Project
project_idtextRequired - The project. Pick one, or give its id.
- Name
nametext - A new name. Leave empty to keep it.
- Project leader
leader_idtext - Who leads the project. Leave empty to keep it.
- Company
company_idtext - The customer the project is for. Leave empty to keep it.
- Project number
identifiertext - The project's number, such as P-123. Needed only when your account numbers projects by hand. Leave empty to keep it.
- Start date
start_datedate - When the project starts. Leave empty to keep it.
- Finish date
finish_datedate - When the project ends. Leave empty to keep it.
- Hourly rate
billing_varianttext - How hourly rates are set. Leave empty to keep it.One of:
project(One rate for the project),task(A rate per task),user(A rate per person). - Rate per hour
hourly_ratenumber - The hourly rate, in the project's currency. Leave empty to keep it.At least 0.
- Budget
budgetnumber - The budget, in the project's currency. Leave empty to keep it.At least 0.
- Notes
infotext - Internal notes on the project. Leave empty to keep it.
- Tags
tagslist - Tags to set, such as Print or Digital.
- Fixed price
fixed_pricetext - Yes for a fixed price, No to bill by the hour. Leave empty to keep it.One of:
yes,no.
Outputs
projectobject- The project
Example output
{
"project": {
"active": true,
"archived_on": null,
"billable": true,
"billing_variant": "project",
"budget": 20000,
"co_leader": null,
"color": "#38b5eb",
"created_at": "2026-10-01T09:00:00Z",
"currency": "EUR",
"custom_properties": {},
"customer": {
"id": 760253573,
"name": "Acme Ltd"
},
"finish_date": "2026-12-31",
"fixed_price": false,
"hourly_rate": 120,
"id": 1185211,
"identifier": "P-123",
"info": null,
"leader": {
"firstname": "Anna",
"id": 933590696,
"lastname": "Muster"
},
"name": "Website relaunch",
"retainer": false,
"start_date": "2026-10-01",
"tags": [
"Digital"
],
"tasks": [
{
"active": true,
"billable": true,
"budget": null,
"created_at": "2026-10-01T09:00:00Z",
"description": null,
"hourly_rate": 120,
"id": 889229,
"name": "Design",
"updated_at": "2026-10-01T09:00:00Z"
}
],
"updated_at": "2026-10-02T09:00:00Z"
}
}Update time entry
Change a time entry's day, project, task, hours, description or billable setting. Only the fields given change; a billed or locked entry can't be changed.
Inputs
- Time entry ID
activity_idtextRequired - The time entry's id, from 'List time entries' or an earlier step.
- Date
datedate - A new day for the entry. Leave empty to keep it.
- Project
project_idtext - Move the entry to this project. Leave empty to keep it.
- Task
task_idtext - Move the entry to this task of the project. Leave empty to keep it.
- Hours
hoursnumber - Time spent, in hours, such as 1.5 for an hour and a half.From 0 to 24.
- Description
descriptiontext - What the time was spent on.
- Billable
billabletext - Whether the time can be billed. Leave empty for the project's default.One of:
yes,no. - Tag
tagtext - A label of your own for the entry, such as RMT-123.
Outputs
activityobject- The time entry
Example output
{
"activity": {
"billable": true,
"billed": false,
"created_at": "2026-11-10T16:00:00Z",
"customer": {
"id": 760253573,
"name": "Acme Ltd"
},
"date": "2026-11-10",
"description": "Homepage layout",
"hourly_rate": 120,
"hours": 1.5,
"id": 988913743,
"invoice_id": null,
"project": {
"billable": true,
"id": 1185211,
"identifier": "P-123",
"name": "Website relaunch"
},
"remote_id": null,
"remote_service": null,
"remote_url": null,
"seconds": 5400,
"tag": "",
"task": {
"billable": true,
"id": 889229,
"name": "Design"
},
"timer_started_at": null,
"updated_at": "2026-11-10T16:00:00Z",
"user": {
"firstname": "Anna",
"id": 933590696,
"lastname": "Muster"
},
"worked_seconds": 5400
}
}