--- title: "Create a new Activity" method: POST path: "/activities.json" tags: ["Activities"] --- # Create a new Activity `POST /activities.json` Outlines the parameters and data fields used when creating a new Activity For a firm with mandatory LEDES billing enabled, a **billable** entry on a Matter whose `require_utbms_codes` is `true` must carry UTBMS codes: - **TimeEntry** — `activity_description[utbms_activity_id]` and `activity_description[utbms_task_id]`. - **ExpenseEntry**, **HardCostEntry**, and **SoftCostEntry** — `utbms_expense[id]`. An entry that lacks them returns 422 with `error.errors.activity_description` or `error.errors.utbms_expense` set. Exceptions: `non_billable` entries, flat-rate entries or matters, and `contingency` matters. ## Query parameters - `fields` string ## Headers - `X-API-VERSION` string ## Request body - object - `data` object, required - `activity_description` object - `id` integer — The unique identifier for a single ActivityDescription associated with the Activity. Optional. Omit it to leave the activity description unset on create, or unchanged on update. To attach a UTBMS activity description, send `activity_description[utbms_activity_id]` and `activity_description[utbms_task_id]` instead. Ignored for ExpenseEntry, HardCostEntry, and SoftCostEntry. - `utbms_task_id` integer — The unique identifier for a single UtbmsTask associated with the Activity. Must be sent together with `activity_description[utbms_activity_id]` unless `activity_description[id]` is supplied. Required on a billable TimeEntry when the matter's `require_utbms_codes` is true, unless `activity_description[id]` references an existing UTBMS activity description. - `utbms_activity_id` integer — The unique identifier for a single UtbmsActivity associated with the Activity. Required on a billable TimeEntry when the matter's `require_utbms_codes` is true, unless `activity_description[id]` references an existing UTBMS activity description. - `calendar_entry` object - `id` integer — The unique identifier for a single CalendarEntry associated with the Activity. The keyword `null` is not valid for this field. - `client_portal` object - `id` integer — The unique identifier for a single ClientPortal associated with the Activity. The keyword `null` is not valid for this field. - `communication` object - `id` integer — The unique identifier for a single Communication associated with the Activity. The keyword `null` is not valid for this field. - `contact_note` object - `id` integer — The unique identifier for a single Note associated with the Activity. The keyword `null` is not valid for this field. - `date` string, date, required — The date the Activity was performed. (Expects an ISO-8601 date). - `expense_category` object - `id` integer — The unique identifier for a single ExpenseCategory associated with an Activity. Use the keyword `null` to specify no association. - `input_tax_settings` object[] — Array of objects, with each object representing an input tax setting that can be applied to a hard cost expense entry with 'tax_rate_configuration_id', 'order', and 'rule' as the object properties. - `tax_rate_configuration_id` integer, required — The unique identifier of the tax rate configuration associated with the input tax setting. - `order` integer, required — The order in which the input tax is applied. Up to two input taxes can be configured — order 1 is applied first, order 2 second. Whether the second compounds on the first depends on its 'rule'. - `rule` 'Pre' | 'Post' — Controls how the input tax is applied. 'Pre' calculates it on the base amount; 'Post' compounds it on top of the preceding tax. The input tax with order 1 is always 'Pre'. - `matter` object - `id` integer — The unique identifier for a single Matter associated with the Activity. The keyword `null` is not valid for this field. - `matter_note` object - `id` integer — The unique identifier for a single Note associated with the Activity. The keyword `null` is not valid for this field. - `no_charge` boolean — Whether the non-billable *Activity* will be shown on the bill. - `non_billable` boolean — Whether or not this Activity is prevented from appearing as a line item in a bill. Only valid for non-billed TimeEntries, and with the exception of the Activity having no_charge set to true. - `note` string — A custom note to describe what the Activity is for. - `price` number, double — For an ExpenseEntry, HardCostEntry, and SoftCostEntry, it is the expense amount. [Support Link for ExpenseEntry](https://help.clio.com/hc/articles/9289745356571-Expenses) [Support Link for HardCostEntry and SoftCostEntry](https://help.clio.com/hc/articles/9289745356571-Expenses#enable-hard-and-soft-cost-expenses-0-0) For a TimeEntry, it is the hourly or flat amount. When updating a TimeEntry, if the price is not given or the user does not have the permission to view the rate, and its activity description, matter and/or user is changed, the price is reset according to the rate defined for the activity description, matter, client or user. [Support Link for Rates Hierarchy](https://help.clio.com/hc/articles/9289801180187-Rates-and-Rate-Hierarchies-) [Support Link for Billing Rate Visibility](https://help.clio.com/hc/articles/9285360193819-Permissions-and-Billing-Rates#billing-rate-visibility-0-3) - `quantity` number, double — The field is applicable to TimeEntry, ExpenseEntry, and SoftCostEntry. **Version <= 4.0.3:** The number of hours the TimeEntry took. **Latest version:** The number of seconds the TimeEntry took. - `reference` string — A check reference for a HardCostEntry. - `start_timer` boolean — Whether or not a timer should be started for this Activity. Only valid for non-FlatRate, non-billed TimeEntries. - `task` object - `id` integer — The unique identifier for a single Task associated with the Activity. The keyword `null` is not valid for this field. - `tax_setting` 'no_tax' | 'tax_1_only' | 'tax_2_only' | 'tax_1_and_tax_2' — The option denoting whether primary tax, secondary tax, or both is applied to an expense entry. - `tax_settings` object[] — Array of objects, with each object representing a tax setting that is applied to an expense entry with 'tax_rate_configuration_id', 'order', and 'rule' as the object properties. - `tax_rate_configuration_id` integer, required — The unique identifier of the tax rate configuration. - `order` integer, required — The order in which the tax setting should be applied. - `rule` 'Pre' | 'Post' — The rule determining when the tax setting should be applied - `text_message_conversation` object - `id` integer — The unique identifier for a single TextMessageConversation associated with the Activity. The keyword `null` is not valid for this field. - `type` 'TimeEntry' | 'ExpenseEntry' | 'HardCostEntry' | 'SoftCostEntry', required — The type of the Activity. - `user` object - `id` integer — The unique identifier for a single User associated with the Activity. Use the keyword `null` to specify no association. On creation, if no user is specified, it will default to the current user. If a TimeEntry is created by a Clio Connect user, the field is not editable. - `utbms_expense` object - `id` integer — The unique identifier for a single UtbmsExpense associated with the Activity. Use `null` to specify no association. Required on a billable ExpenseEntry, HardCostEntry, or SoftCostEntry when the matter's `require_utbms_codes` is true. - `vendor` object - `id` integer — The unique identifier for a single Contact associated with a HardCostEntry. Use the keyword `null` to specify no association. ## Response `201` Created ## Other responses - `400` — Bad Request - `401` — Unauthorized - `403` — Forbidden - `404` — Not Found - `422` — Unprocessable Entity - `429` — Too Many Requests --- [API](https://skmtc.net/clio/apis/clio-api-documentation.md) · [All operations](https://skmtc.net/clio/apis/clio-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clio/clio-api-documentation/revisions/73791ddd1207/schema)