---
title: "Creating one or many Cost Rates"
method: POST
path: "/cost_rates"
tags: ["Cost Rates"]
---

# Creating one or many Cost Rates

`POST /cost_rates`

## Request

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

Creates a new cost rate for a specified account membership and currency. If a cost rate already exists
for the specified account membership and currency, it will be overridden, effectively making this an
update request as well. Up to 100 cost rates can be created or updated at once.

**Note**: Updating a cost rate will set the cost rate for future work. Existing time entries will not be affected.


This endpoint returns structured Cost Rate 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 `cost_rates` top-level JSON key.
Please see our [Response Format](#section/Response-Format) section for more information.

## Query parameters

- `include` string

## Request body

- object
  - `cost_rate` object
    - `account_membership_id` integer, required: The ID of the account membership associated to the cost rate.
    - `currency` string, required: The ISO currency code for the cost rate currency.
    - `amount_in_subunits` integer, required: The cost amount, in subunits of the currency (for example, cents for US dollars).
  - `cost_rates` object[]: Multiple cost rates and their attributes in an array.
    - `account_membership_id` integer, required: The ID of the account membership associated to the cost rate.
    - `currency` string, required: The ISO currency code for the cost rate currency.
    - `amount_in_subunits` integer, required: The cost amount, in subunits of the currency (for example, cents for US dollars).

## Response `200`

Cost Rate 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
  - `cost_rates` object
  - `account_memberships` 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)