# MOCO

> 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.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/moco

## Actions

### 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_id`, text, required): The project. Pick one, or give its id.
- Name (`name`, text, required): The task's name.
- Billable (`billable`, text): Whether time on the task can be billed. Defaults to yes. One of: `yes`, `no`.
- Rate per hour (`hourly_rate`, number): The task's hourly rate. At least 0.
- Budget (`budget`, number): The task's budget. At least 0.
- Description (`description`, text): What the task covers.

**Outputs**

- `project_id` (number): The project
- `task` (object): The new task

**Example output**

```json
{
  "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 (`name`, text, required): The company's name.
- Type (`company_type`, text): Customer, supplier or other organization. Defaults to customer. One of: `customer`, `supplier`, `organization`. Default: `customer`.
- Currency (`currency`, text): The three-letter currency a customer is billed in, such as EUR. Needed for a customer.
- Customer number (`identifier`, text): The customer's number, such as K-123, when your account numbers them by hand.
- Email (`email`, text): The company's email address.
- Phone (`phone`, text): The company's phone number.
- Website (`website`, text): The company's website.
- Address (`address`, text): The postal address, one line per row.
- Country (`country_code`, text): The two-letter country code, such as DE.
- VAT ID (`vat_identifier`, text): The company's VAT identification number.
- Notes (`info`, text): Notes on the company.
- Responsible person (`moco_user_id`, text): Who looks after the company.
- Tags (`tags`, list): Tags to set, such as Print or Digital.

**Outputs**

- `company` (object): The company

**Example output**

```json
{
  "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 (`lastname`, text, required): The person's last name.
- First name (`firstname`, text): The person's first name.
- Gender (`gender`, text): 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_id`, text): The company the person works at.
- Job title (`job_position`, text): The person's job, such as Account Manager.
- Title (`title`, text): An academic title, such as Dr.
- Work email (`work_email`, text): The person's work email address.
- Work phone (`work_phone`, text): The person's work phone number.
- Mobile phone (`mobile_phone`, text): The person's mobile number.
- Notes (`info`, text): Notes on the person.
- Tags (`tags`, list): Tags to set, such as Print or Digital.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "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 (`name`, text, required): The project's name.
- Currency (`currency`, text, required): The three-letter currency it is billed in, such as EUR. It cannot be changed later.
- Project leader (`leader_id`, text, required): Who leads the project.
- Company (`company_id`, text, required): The customer the project is for.
- Project number (`identifier`, text): The project's number, such as P-123. Needed only when your account numbers projects by hand.
- Start date (`start_date`, date): When the project starts.
- Finish date (`finish_date`, date): When the project ends.
- Hourly rate (`billing_variant`, text): 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_rate`, number): The hourly rate, in the project's currency. At least 0.
- Budget (`budget`, number): The budget, in the project's currency. At least 0.
- Notes (`info`, text): Internal notes on the project.
- Tags (`tags`, list): Tags to set, such as Print or Digital.
- Fixed price (`fixed_price`, true/false): Bill the project at a fixed price rather than by the hour. Default: `false`.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "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_id`, text, required): The company. Pick one, or give its id.

**Outputs**

- `company_id` (number): The company deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "company_id": 760253573,
  "deleted": true
}
```

### Delete contact

Delete a contact person.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts' or an earlier step.

**Outputs**

- `contact_id` (number): The contact deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "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_id`, text, required): The project. Pick one, or give its id.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `project_id` (number): The project deleted

**Example output**

```json
{
  "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_id`, text, required): The time entry's id, from 'List time entries' or an earlier step.

**Outputs**

- `activity_id` (number): The time entry deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "activity_id": 988913743,
  "deleted": true
}
```

### Get project

Get one project with its customer, leader, dates, budget, rate and tasks.

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, or give its id.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "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_type`, text): Only companies of this type. One of: `customer`, `supplier`, `organization`.
- Search (`term`, text): Words to find in the name.
- Tags (`tags`, list): Only records with these tags.
- Include archived (`include_archived`, true/false): Also list archived ones. Default: `false`.
- Page (`page`, number): Which page to get, from 1. Use it when the last run said there are more. At least 1.
- Page size (`per_page`, number): How many to return, 1 to 100. MOCO's default is 100. From 1 to 100.

**Outputs**

- `companies` (list): The companies
- `count` (number): How many on this page
- `has_more` (true/false): True when there is a next page: run again with the next page
- `page` (number): The page number, from 1
- `total` (number): How many match, on every page

**Example output**

```json
{
  "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 (`term`, text): Words to find in the name, email or company.
- Tags (`tags`, list): Only records with these tags.
- Page (`page`, number): Which page to get, from 1. Use it when the last run said there are more. At least 1.
- Page size (`per_page`, number): How many to return, 1 to 100. MOCO's default is 100. From 1 to 100.

**Outputs**

- `contacts` (list): The contacts
- `count` (number): How many on this page
- `has_more` (true/false): True when there is a next page: run again with the next page
- `page` (number): The page number, from 1
- `total` (number): How many match, on every page

**Example output**

```json
{
  "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 (`status`, list): 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_from`, date): Only invoices dated on or after this day.
- Dated to (`date_to`, date): Only invoices dated on or before this day.
- Company (`company_id`, text): Only this customer's invoices.
- Project (`project_id`, text): Only this project's invoices.
- Search (`term`, text): Words to find in the invoice.
- Page (`page`, number): Which page to get, from 1. Use it when the last run said there are more. At least 1.
- Page size (`per_page`, number): How many to return, 1 to 100. MOCO's default is 100. From 1 to 100.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): True when there is a next page: run again with the next page
- `invoices` (list): The invoices
- `page` (number): The page number, from 1
- `total` (number): How many match, on every page

**Example output**

```json
{
  "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_id`, text, required): The project. Pick one, or give its id.
- Page (`page`, number): Which page to get, from 1. Use it when the last run said there are more. At least 1.
- Page size (`per_page`, number): How many to return, 1 to 100. MOCO's default is 100. From 1 to 100.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): True when there is a next page: run again with the next page
- `page` (number): The page number, from 1
- `project_id` (number): The project
- `tasks` (list): The project's tasks
- `total` (number): How many match, on every page

**Example output**

```json
{
  "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_id`, text): Only this customer's projects.
- Project leader (`leader_id`, text): Only projects this person leads.
- Search (`term`, text): Words to find in the name, number or customer.
- Tags (`tags`, list): Only records with these tags.
- Include archived (`include_archived`, true/false): Also list archived ones. Default: `false`.
- Page (`page`, number): Which page to get, from 1. Use it when the last run said there are more. At least 1.
- Page size (`per_page`, number): How many to return, 1 to 100. MOCO's default is 100. From 1 to 100.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): True when there is a next page: run again with the next page
- `page` (number): The page number, from 1
- `projects` (list): The projects
- `total` (number): How many match, on every page

**Example output**

```json
{
  "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_archived`, true/false): Also list archived ones. Default: `false`.
- Email (`email`, text): Only the person with this exact email address.
- Page (`page`, number): Which page to get, from 1. Use it when the last run said there are more. At least 1.
- Page size (`per_page`, number): How many to return, 1 to 100. MOCO's default is 100. From 1 to 100.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): True when there is a next page: run again with the next page
- `page` (number): The page number, from 1
- `total` (number): How many match, on every page
- `users` (list): The people

**Example output**

```json
{
  "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_date`, date): Only entries on or after this day.
- To (`to_date`, date): Only entries on or before this day.
- Project (`project_id`, text): Only entries on this project.
- Task (`task_id`, text): Only entries on this task of the project.
- Person (`moco_user_id`, text): Only this person's entries.
- Company (`company_id`, text): Only entries for this customer.
- Billable (`billable`, text): Only billable, or only non-billable, entries. One of: `yes`, `no`.
- Billed (`billed`, text): Only billed, or only not yet billed, entries. One of: `yes`, `no`.
- Search (`term`, text): Words to find in the description or tag.
- Page (`page`, number): Which page to get, from 1. Use it when the last run said there are more. At least 1.
- Page size (`per_page`, number): How many to return, 1 to 100. MOCO's default is 100. From 1 to 100.

**Outputs**

- `activities` (list): The time entries
- `count` (number): How many on this page
- `has_more` (true/false): True when there is a next page: run again with the next page
- `page` (number): The page number, from 1
- `total` (number): How many match, on every page
- `total_hours` (number): The hours on this page added up

**Example output**

```json
{
  "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 (`date`, date, required): The day the work was done.
- Project (`project_id`, text, required): The project the time is for.
- Task (`task_id`, text, required): The project's task (service) the time is for.
- Hours (`hours`, number): Time spent, in hours, such as 1.5 for an hour and a half. From 0 to 24.
- Description (`description`, text): What the time was spent on.
- Billable (`billable`, text): Whether the time can be billed. Leave empty for the project's default. One of: `yes`, `no`.
- Tag (`tag`, text): A label of your own for the entry, such as RMT-123.

**Outputs**

- `activity` (object): The time entry

**Example output**

```json
{
  "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_id`, text, required): The company. Pick one, or give its id.
- Name (`name`, text): A new name. Leave empty to keep it.
- Currency (`currency`, text): A new currency code. Leave empty to keep it.
- Customer number (`identifier`, text): The customer's number, such as K-123, when your account numbers them by hand. Leave empty to keep it.
- Email (`email`, text): The company's email address. Leave empty to keep it.
- Phone (`phone`, text): The company's phone number. Leave empty to keep it.
- Website (`website`, text): The company's website. Leave empty to keep it.
- Address (`address`, text): The postal address, one line per row. Leave empty to keep it.
- Country (`country_code`, text): The two-letter country code, such as DE. Leave empty to keep it.
- VAT ID (`vat_identifier`, text): The company's VAT identification number. Leave empty to keep it.
- Notes (`info`, text): Notes on the company. Leave empty to keep it.
- Responsible person (`moco_user_id`, text): Who looks after the company. Leave empty to keep it.
- Tags (`tags`, list): Tags to set, such as Print or Digital.

**Outputs**

- `company` (object): The company

**Example output**

```json
{
  "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_id`, text, required): The project. Pick one, or give its id.
- Name (`name`, text): A new name. Leave empty to keep it.
- Project leader (`leader_id`, text): Who leads the project. Leave empty to keep it.
- Company (`company_id`, text): The customer the project is for. Leave empty to keep it.
- Project number (`identifier`, text): 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_date`, date): When the project starts. Leave empty to keep it.
- Finish date (`finish_date`, date): When the project ends. Leave empty to keep it.
- Hourly rate (`billing_variant`, text): 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_rate`, number): The hourly rate, in the project's currency. Leave empty to keep it. At least 0.
- Budget (`budget`, number): The budget, in the project's currency. Leave empty to keep it. At least 0.
- Notes (`info`, text): Internal notes on the project. Leave empty to keep it.
- Tags (`tags`, list): Tags to set, such as Print or Digital.
- Fixed price (`fixed_price`, text): Yes for a fixed price, No to bill by the hour. Leave empty to keep it. One of: `yes`, `no`.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "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_id`, text, required): The time entry's id, from 'List time entries' or an earlier step.
- Date (`date`, date): A new day for the entry. Leave empty to keep it.
- Project (`project_id`, text): Move the entry to this project. Leave empty to keep it.
- Task (`task_id`, text): Move the entry to this task of the project. Leave empty to keep it.
- Hours (`hours`, number): Time spent, in hours, such as 1.5 for an hour and a half. From 0 to 24.
- Description (`description`, text): What the time was spent on.
- Billable (`billable`, text): Whether the time can be billed. Leave empty for the project's default. One of: `yes`, `no`.
- Tag (`tag`, text): A label of your own for the entry, such as RMT-123.

**Outputs**

- `activity` (object): The time entry

**Example output**

```json
{
  "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
  }
}
```
