---
title: "Creating Client Invoice Defaults"
method: POST
path: "/client_invoice_defaults"
tags: ["Client Invoice Defaults"]
---

# Creating Client Invoice Defaults

`POST /client_invoice_defaults`

## Request

- Base URL: `https://api.mavenlink.com/api/v1`
- URL: `https://api.mavenlink.com/api/v1/client_invoice_defaults`
- Auth: none declared

This endpoint returns structured Client Invoice Defaults objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array
and will be indexed by ID in the `client_invoice_defaults` top-level JSON key.
Please see our [Response Format](#section/Response-Format) section for more information.

## Request body

- object
  - `client_invoice_default` object
    - `client_account_id` integer: The user ID of the client being invoiced.
    - `time_rollup_type` integer: Options for how time is formatted on an invoice. These options include 'Detailed', 'Grouped by task', and 'Grouped by person, then task'. They are represented by the numbers 0, 1, and 2, respectively.
    - `expense_rollup_type` integer: Options for how expenses are formatted on an invoice. These options include 'Detailed' and 'Grouped'. They are represented by the numbers 0 and 1, respectively.
    - `rich_text` string: The default rich text shown as additional details on the invoice.
    - `show_project_names` integer: Whether project names should be shown on the invoice.
    - `show_task_names` boolean: Whether task names should be shown for invoice items.
    - `show_subtotals` boolean: Whether subtotals should be shown for time entries on the invoice.
    - `show_creators` boolean: Whether the name of the person who created the entry should be shown.
    - `show_dates` boolean: Whether dates for items on the invoice should be shown.
    - `show_notes` boolean: Whether notes for items on the invoice should be shown.
    - `show_hours` boolean: Whether hours logged on a time entry on the invoice should be shown.
    - `show_rates` boolean: Whether the rate for the item should be shown.
    - `show_tax` boolean: Whether the item's taxable amount should be shown.
    - `show_roles` boolean: Whether the role of the person who created the item should be shown.

## Response `200`

Client Invoice Defaults has been created.

- object
  - `count` integer
  - `meta` object
    - `count` integer
    - `page_count` integer
    - `page_number` integer
    - `page_size` integer
  - `results` object[]
    - `key` string
    - `id` string
  - `client_invoice_defaults` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized request
- `403`: Forbidden request
- `404`: Page Not Found
- `422`: Unprocessable Entity
- `503`: Service is unavailable

---

[API](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation.md) - [All operations](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/revisions/9d4ebed2fa98?raw)