# Create a Smokeball expense entry (internal)

**POST /legal/smokeball/matters/{matterId}/billing/expense**

Test route: creates a billable expense (`amount`, `description`, an optional `date` that defaults to today and an optional expense category) directly on a Smokeball matter by its Smokeball id, through the firm's primary connection, and returns the created entry in `activity`. Requires an org admin or owner; returns 403 while the Smokeball integration is turned off.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Access token


## Parameters
### Headers

- **organization** (string)
  id of the selected (active) organization


### Path parameters

- **matterId** (string)
  Smokeball matter ID to attach the expense to



### Body: application/json (object)

- **amount** (number)
  Expense amount in the matter currency.

- **description** (string)
  Description shown on the provider expense line item.

- **date** (string)
  ISO-8601 date the expense was incurred. Defaults to today when omitted.

- **expenseCategoryId** (string)
  Optional provider expense-category / activity-code id used to categorize the expense.



## Responses
### 201


#### Body: application/json (object)
- **data** (object)

- **statusCode** (number)

- **timestamp** (string(date-time))



[Powered by Bump.sh](https://bump.sh)