---
title: "Rates creation"
method: POST
path: "/workspaces/{workspace_id}/rates"
tags: ["rates"]
---

# Rates creation

`POST /workspaces/{workspace_id}/rates`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/workspaces/{workspace_id}/rates`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/workspaces/:workspace_id/rates/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new rate.

## Path parameters

- `workspace_id` integer, required

## Request body

- DtoCreationRequest
  - `external` boolean: For safe, the default value is false.

## Response `201`

Successful operation.

- DtoGetResponse
  - `created_at` string
  - `created_by` integer
  - `creator_name` string
  - `description` string
  - `id` integer
  - `link` DtoLinkResponse
    - `external` boolean
    - `token` string
  - `locked` boolean
  - `name` string
  - `organization_id` integer
  - `permissions` DtoResourcePermissionResponse[]
    - `allowed_actions` string[]
    - `group_id` integer
    - `organization_id` integer
    - `permission_type` string
    - `user_id` integer
    - `workspace_id` integer
  - `pinned` boolean
  - `plan` string
  - `preferences` object
  - `query` DtoQueryResponse
    - `aggregation_filters` DtoAggFilterRequest[]
      - `conditions` DtoAggFilterRequest[]
      - `operator` string
      - `property` string
      - `value` unknown
    - `aggregations` DtoAggregationRequest[]
      - `alias` string
      - `function` string, required
      - `property` string, required
    - `attributes` DtoAttributeRequest[]
      - `property` string
    - `filters` DtoFilterRequest[]
      - `conditions` DtoFilterRequest[]
      - `operator` string
      - `property` string
      - `value` unknown
    - `groupings` DtoGroupingRequest[]
      - `alias` string
      - `property` string, required
      - `show_empty` boolean
    - `limit` integer
    - `ordinations` DtoOrdinationRequest[]
      - `direction` string
      - `nulls` string
      - `property` string, required
    - `period` DtoPeriodRequest, required
      - `from` string
      - `preset` string
      - `to` string
    - `preferences` object
    - `transformations` DtoTransformationRequest[]
      - `name` string, required
      - `parameters` string[], required
    - `v3_query_params` string
  - `source` string
  - `type` string
  - `updated_at` string

## Other responses

- `400`: Possible error messages:<ul><li>Request payload must be informed</li><li>Invalid workspace ID</li></ul>
- `402`: Billable rates are available for Starter and higher plans.
- `403`: User cannot access billable rate(s).
- `500`: Internal Server Error

---

[API](https://skmtc.dev/toggl/apis/toggl-api.md) - [All operations](https://skmtc.dev/toggl/apis/toggl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toggl/apis/toggl-api/revisions/3085aee16990?raw)