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

ActionWhat it does
Add task to projectAdd a task (a service, such as Design) to a project, so time can be logged on it.
Create companyCreate a customer, supplier or organization with its contact details.
Create contactAdd a contact person, optionally at a company, with their job and work details.
Create projectCreate a project for a customer, billed by the hour or at a fixed price, with its leader, dates, budget and rate.
Delete companyDelete a company.
Delete contactDelete a contact person.
Delete projectDelete a project.
Delete time entryDelete a time entry.
Get projectGet one project with its customer, leader, dates, budget, rate and tasks.
List companiesList customers, suppliers and organizations, by type, tags or a search.
List contactsList contact people, searched by name, email or company, or by tags.
List invoicesList invoices with their number, totals and status, filtered by status, invoice date, customer or project.
List project tasksList a project's tasks (its services), which time is logged against.
List projectsList projects, filtered by customer, project leader, tags or a search of name, number and customer.
List staffList the people in your MOCO account, with their ids for the project leader and person fields.
List time entriesList logged time, filtered by dates, project, task, person, customer or billing state, with the hours on the page added up.
Log timeLog time on a project's task for a day, as the person whose API key is connected.
Update companyChange a company's name, contact details, address, VAT ID, notes, responsible person or tags.
Update projectChange a project's name, leader, customer, dates, budget, rate, notes or tags.
Update time entryChange 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

Projectproject_idtextRequired
The project. Pick one, or give its id.
NamenametextRequired
The task's name.
Billablebillabletext
Whether time on the task can be billed. Defaults to yes.One of: yes, no.
Rate per hourhourly_ratenumber
The task's hourly rate.At least 0.
Budgetbudgetnumber
The task's budget.At least 0.
Descriptiondescriptiontext
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

NamenametextRequired
The company's name.
Typecompany_typetext
Customer, supplier or other organization. Defaults to customer.One of: customer, supplier, organization. Default: customer.
Currencycurrencytext
The three-letter currency a customer is billed in, such as EUR. Needed for a customer.
Customer numberidentifiertext
The customer's number, such as K-123, when your account numbers them by hand.
Emailemailtext
The company's email address.
Phonephonetext
The company's phone number.
Websitewebsitetext
The company's website.
Addressaddresstext
The postal address, one line per row.
Countrycountry_codetext
The two-letter country code, such as DE.
VAT IDvat_identifiertext
The company's VAT identification number.
Notesinfotext
Notes on the company.
Responsible personmoco_user_idtext
Who looks after the company.
Tagstagslist
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 namelastnametextRequired
The person's last name.
First namefirstnametext
The person's first name.
Gendergendertext
Used for the salutation in MOCO's letters. Defaults to not stated.One of: U (Not stated), F (Female), M (Male). Default: U.
Companycompany_idtext
The company the person works at.
Job titlejob_positiontext
The person's job, such as Account Manager.
Titletitletext
An academic title, such as Dr.
Work emailwork_emailtext
The person's work email address.
Work phonework_phonetext
The person's work phone number.
Mobile phonemobile_phonetext
The person's mobile number.
Notesinfotext
Notes on the person.
Tagstagslist
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

NamenametextRequired
The project's name.
CurrencycurrencytextRequired
The three-letter currency it is billed in, such as EUR. It cannot be changed later.
Project leaderleader_idtextRequired
Who leads the project.
Companycompany_idtextRequired
The customer the project is for.
Project numberidentifiertext
The project's number, such as P-123. Needed only when your account numbers projects by hand.
Start datestart_datedate
When the project starts.
Finish datefinish_datedate
When the project ends.
Hourly ratebilling_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 hourhourly_ratenumber
The hourly rate, in the project's currency.At least 0.
Budgetbudgetnumber
The budget, in the project's currency.At least 0.
Notesinfotext
Internal notes on the project.
Tagstagslist
Tags to set, such as Print or Digital.
Fixed pricefixed_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

Companycompany_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 IDcontact_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

Projectproject_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 IDactivity_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

Projectproject_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

Typecompany_typetext
Only companies of this type.One of: customer, supplier, organization.
Searchtermtext
Words to find in the name.
Tagstagslist
Only records with these tags.
Include archivedinclude_archivedtrue/false
Also list archived ones.Default: false.
Pagepagenumber
Which page to get, from 1. Use it when the last run said there are more.At least 1.
Page sizeper_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

Searchtermtext
Words to find in the name, email or company.
Tagstagslist
Only records with these tags.
Pagepagenumber
Which page to get, from 1. Use it when the last run said there are more.At least 1.
Page sizeper_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

Statusstatuslist
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 fromdate_fromdate
Only invoices dated on or after this day.
Dated todate_todate
Only invoices dated on or before this day.
Companycompany_idtext
Only this customer's invoices.
Projectproject_idtext
Only this project's invoices.
Searchtermtext
Words to find in the invoice.
Pagepagenumber
Which page to get, from 1. Use it when the last run said there are more.At least 1.
Page sizeper_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

Projectproject_idtextRequired
The project. Pick one, or give its id.
Pagepagenumber
Which page to get, from 1. Use it when the last run said there are more.At least 1.
Page sizeper_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

Companycompany_idtext
Only this customer's projects.
Project leaderleader_idtext
Only projects this person leads.
Searchtermtext
Words to find in the name, number or customer.
Tagstagslist
Only records with these tags.
Include archivedinclude_archivedtrue/false
Also list archived ones.Default: false.
Pagepagenumber
Which page to get, from 1. Use it when the last run said there are more.At least 1.
Page sizeper_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 archivedinclude_archivedtrue/false
Also list archived ones.Default: false.
Emailemailtext
Only the person with this exact email address.
Pagepagenumber
Which page to get, from 1. Use it when the last run said there are more.At least 1.
Page sizeper_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

Fromfrom_datedate
Only entries on or after this day.
Toto_datedate
Only entries on or before this day.
Projectproject_idtext
Only entries on this project.
Tasktask_idtext
Only entries on this task of the project.
Personmoco_user_idtext
Only this person's entries.
Companycompany_idtext
Only entries for this customer.
Billablebillabletext
Only billable, or only non-billable, entries.One of: yes, no.
Billedbilledtext
Only billed, or only not yet billed, entries.One of: yes, no.
Searchtermtext
Words to find in the description or tag.
Pagepagenumber
Which page to get, from 1. Use it when the last run said there are more.At least 1.
Page sizeper_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

DatedatedateRequired
The day the work was done.
Projectproject_idtextRequired
The project the time is for.
Tasktask_idtextRequired
The project's task (service) the time is for.
Hourshoursnumber
Time spent, in hours, such as 1.5 for an hour and a half.From 0 to 24.
Descriptiondescriptiontext
What the time was spent on.
Billablebillabletext
Whether the time can be billed. Leave empty for the project's default.One of: yes, no.
Tagtagtext
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

Companycompany_idtextRequired
The company. Pick one, or give its id.
Namenametext
A new name. Leave empty to keep it.
Currencycurrencytext
A new currency code. Leave empty to keep it.
Customer numberidentifiertext
The customer's number, such as K-123, when your account numbers them by hand. Leave empty to keep it.
Emailemailtext
The company's email address. Leave empty to keep it.
Phonephonetext
The company's phone number. Leave empty to keep it.
Websitewebsitetext
The company's website. Leave empty to keep it.
Addressaddresstext
The postal address, one line per row. Leave empty to keep it.
Countrycountry_codetext
The two-letter country code, such as DE. Leave empty to keep it.
VAT IDvat_identifiertext
The company's VAT identification number. Leave empty to keep it.
Notesinfotext
Notes on the company. Leave empty to keep it.
Responsible personmoco_user_idtext
Who looks after the company. Leave empty to keep it.
Tagstagslist
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

Projectproject_idtextRequired
The project. Pick one, or give its id.
Namenametext
A new name. Leave empty to keep it.
Project leaderleader_idtext
Who leads the project. Leave empty to keep it.
Companycompany_idtext
The customer the project is for. Leave empty to keep it.
Project numberidentifiertext
The project's number, such as P-123. Needed only when your account numbers projects by hand. Leave empty to keep it.
Start datestart_datedate
When the project starts. Leave empty to keep it.
Finish datefinish_datedate
When the project ends. Leave empty to keep it.
Hourly ratebilling_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 hourhourly_ratenumber
The hourly rate, in the project's currency. Leave empty to keep it.At least 0.
Budgetbudgetnumber
The budget, in the project's currency. Leave empty to keep it.At least 0.
Notesinfotext
Internal notes on the project. Leave empty to keep it.
Tagstagslist
Tags to set, such as Print or Digital.
Fixed pricefixed_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 IDactivity_idtextRequired
The time entry's id, from 'List time entries' or an earlier step.
Datedatedate
A new day for the entry. Leave empty to keep it.
Projectproject_idtext
Move the entry to this project. Leave empty to keep it.
Tasktask_idtext
Move the entry to this task of the project. Leave empty to keep it.
Hourshoursnumber
Time spent, in hours, such as 1.5 for an hour and a half.From 0 to 24.
Descriptiondescriptiontext
What the time was spent on.
Billablebillabletext
Whether the time can be billed. Leave empty for the project's default.One of: yes, no.
Tagtagtext
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
  }
}

On this page