---
title: "Creating a new Rate Card Role"
method: POST
path: "/rate_card_roles"
tags: ["Rate Card Role (Rate for a Role)"]
---

# Creating a new Rate Card Role

`POST /rate_card_roles`

## Request

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

A Rate Card Role can only be created by an Administrator on the account.


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

## Query parameters

- `include` string

## Request body

- object
  - `rate_card_role` object
    - `rate_card_version_id` integer, required: The ID of the Rate Card Version to which the Rate Card Role belongs.
    - `role_id` integer, required: The ID of the Role being represented by the Rate Card Role.
    - `rate` integer, required: The bill rate, in cents per hour, for the associated role.

## Response `200`

Rate Card Role 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
  - `rate_card_roles` object
  - `roles` object
  - `rate_card_versions` 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)