---
title: "Creating a new Project Accounting Records"
method: POST
path: "/project_accounting_records"
tags: ["Project Accounting Records"]
---

# Creating a new Project Accounting Records

`POST /project_accounting_records`

## Request

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

Creates a single or multiple project accounting records.

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

## Query parameters

- `include` string

## Request body

- object
  - `project_accounting_record` object: A single project accounting record and its attributes.
    - `workspace_id` integer, required: The ID of the project the record belongs to.
    - `start_date` string, date, required: The date the accounting period begins, in ISO8601 format (e.g. `2014-06-25`). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.
    - `end_date` string, date, required: The date the accounting period ends, in ISO8601 format (e.g. `2014-02-25`). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.
    - `currency` string, required: The currency of the record. Valid values are [ISO codes of currencies supported by Kantata OX](https://knowledge.kantata.com/hc/en-us/articles/360041576473).
    - `type` string: The type of project accounting record: * `Baseline` * `Earned Value` * `Earned Value Forecasting` * `Forecasting` * `Recognition` (Default) If not specified, a `Recognition` record is created by default. **Note:** Make sure to include the spaces in `Earned Value` and `Earned Value Forecasting` when making a request.
    - `amount` number, float: The amount being calculated for baseline, forecasting, earned value, earned value forecasting, or revenue recognition within the specified accounting period, up to 2 decimal places (e.g. 575.75). Values can also be negative (e.g. -96.75).
    - `amount_to_date` number, float: The total amount spent to date (for all accounting periods), up to 2 decimal places (e.g. 1252.33). Values can also be negative (e.g. -83.33).
    - `budget` number, float: The budget of the project or task, up to 2 decimal places (e.g. 2457.52). Values can also be negative (e.g. -350.52).
    - `contract_date` string, date: This can be a contract's start or end date in ISO8601 format, or any other date a user prefers. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.
    - `cost` number, float: The cost of the project or task within the specified accounting period, up to 2 decimal places (e.g. 3003.56). Values can also be negative (e.g. -350.72).
    - `cost_eac` number, float: The [estimated cost](https://knowledge.kantata.com/hc/en-us/articles/360004619334-Project-Completion-Estimates) of the project or task when it is completed, up to 2 decimal places (e.g. 8326.55). Values can also be negative (e.g. -426.55). This updates during the course of a project or task, as costs are logged.
    - `cost_to_date` number, float: The total cost accumulated to date for this financial period, up to 2 decimal places (e.g. 5423.12). Values can also be negative (e.g. -750.50).
    - `description` string: This can be a brief description of the record, or anything a user prefers.
    - `fees` number, float: The fees from the specified accounting period, up to 2 decimal places (e.g. 324.53). Values can also be negative (e.g. -41.53).
    - `forecast` number, float: The forecasted revenue for this financial period, up to 2 decimal places (e.g. 12500.75). Values can also be negative (e.g. -2000.50).
    - `hours` number, float: The [hours](https://knowledge.kantata.com/hc/en-us/articles/360059325413) spent within the specified accounting period, up to 2 decimal places (e.g. 23.25). Values can also be negative (e.g. -7.25).
    - `hours_eac` number, float: The [estimated hours](https://knowledge.kantata.com/hc/en-us/articles/360004619334-Project-Completion-Estimates) for the project or task when it is completed, up to 2 decimal places (e.g. 82.25). Values can also be negative (e.g. -22.25). This updates during the course of a project or task, as hours are logged.
    - `hours_etc` number, float: The [estimated hours](https://knowledge.kantata.com/hc/en-us/articles/360004619334-Project-Completion-Estimates) until completion (`hours_eac` - `hours`) of the project or task, up to two decimal places (e.g. 53.25). Values can also be negative (e.g. -10.25).
    - `total_estimated_hours` number, float: The hours initially estimated for the project or task, up to 2 decimal places (e.g. 83.50). Values can also be negative (e.g. -12.25). This value does not change over the course of a project.
    - `total_hours_to_date` number, float: The total hours logged to date for the project or task, up to 2 decimal places (e.g. 32.25). Values can also be negative (e.g. -5.75).
    - `labor_type` string: The type of cost associated with the record. Valid values are `Labor` or `Non-Labor`.
    - `notes` string: This can be any extra information to note about the record.
    - `percent_complete` number, float: How much of the project or task is complete in decimal format, up to 2 places (e.g. 0.75). Values can also be negative (e.g. -.25).
    - `revenue_method` string: The name of the revenue recognition method selected for this project. The following options are available for the [early access feature Revenue Management](https://knowledge.kantata.com/hc/en-us/articles/38986877019803-Revenue-Management-Early-Access): `Time & Materials`, `Time and Materials (Capped)`, `% Complete (Hours)`, and `% Complete (Cost)`.
    - `role_id` integer: The ID of the role associated with the record.
    - `service_type` string: This can be an organization-specific category of services that is related to the record (e.g. Branding, Campaigns, Photography, etc.).
    - `status` string: The status of the record. Valid values: `Draft`, `Pending Approval`, `Approved`, `Cancelled`.
    - `story_id` integer: The ID of the task related to the record.
    - `user_id` integer: The ID of the user associated with the record (e.g. who created the record, who the record was created for, etc.).
    - `external_reference` object: Typically populated programmatically by a third party system via an integration, this is an optional object that holds data from an external system. It connects objects in an external system with objects in Kantata OX (for example, to connect a Jira issue to a Kantata OX Project).
      - `service_name` string, required: The provider name of the integration. If you are adding multiple external references to the same object, the `service_name` must be unique.
      - `service_model` string, required: The object type of the external object this external reference belongs to.
      - `service_model_ref` string, required: The object ID of the external object this external reference belongs to.
      - `status` string: The status of the integration. Options are `successful`, `pending`, or `failed`.
      - `external_message` string: The message on the external object.
      - `external_link` string: The link to the external object.
      - `external_status` string: The status of the external object in the external system.
      - `locked` boolean: Whether the subject is locked.
  - `project_accounting_records` object[]: Multiple project accounting records and their attributes in an array.
    - `workspace_id` integer, required: The ID of the project the record belongs to.
    - `start_date` string, date, required: The date the accounting period begins, in ISO8601 format (e.g. `2014-06-25`). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.
    - `end_date` string, date, required: The date the accounting period ends, in ISO8601 format (e.g. `2014-02-25`). The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.
    - `currency` string, required: The currency of the record. Valid values are [ISO codes of currencies supported by Kantata OX](https://knowledge.kantata.com/hc/en-us/articles/360041576473).
    - `type` string: The type of project accounting record: * `Baseline` * `Earned Value` * `Earned Value Forecasting` * `Forecasting` * `Recognition` (Default) If not specified, a `Recognition` record is created by default. **Note:** Make sure to include the spaces in `Earned Value` and `Earned Value Forecasting` when making a request.
    - `amount` number, float: The amount being calculated for baseline, forecasting, earned value, earned value forecasting, or revenue recognition within the specified accounting period, up to 2 decimal places (e.g. 575.75). Values can also be negative (e.g. -96.75).
    - `amount_to_date` number, float: The total amount spent to date (for all accounting periods), up to 2 decimal places (e.g. 1252.33). Values can also be negative (e.g. -83.33).
    - `budget` number, float: The budget of the project or task, up to 2 decimal places (e.g. 2457.52). Values can also be negative (e.g. -350.52).
    - `contract_date` string, date: This can be a contract's start or end date in ISO8601 format, or any other date a user prefers. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.
    - `cost` number, float: The cost of the project or task within the specified accounting period, up to 2 decimal places (e.g. 3003.56). Values can also be negative (e.g. -350.72).
    - `cost_eac` number, float: The [estimated cost](https://knowledge.kantata.com/hc/en-us/articles/360004619334-Project-Completion-Estimates) of the project or task when it is completed, up to 2 decimal places (e.g. 8326.55). Values can also be negative (e.g. -426.55). This updates during the course of a project or task, as costs are logged.
    - `cost_to_date` number, float: The total cost accumulated to date for this financial period, up to 2 decimal places (e.g. 5423.12). Values can also be negative (e.g. -750.50).
    - `description` string: This can be a brief description of the record, or anything a user prefers.
    - `fees` number, float: The fees from the specified accounting period, up to 2 decimal places (e.g. 324.53). Values can also be negative (e.g. -41.53).
    - `forecast` number, float: The forecasted revenue for this financial period, up to 2 decimal places (e.g. 12500.75). Values can also be negative (e.g. -2000.50).
    - `hours` number, float: The [hours](https://knowledge.kantata.com/hc/en-us/articles/360059325413) spent within the specified accounting period, up to 2 decimal places (e.g. 23.25). Values can also be negative (e.g. -7.25).
    - `hours_eac` number, float: The [estimated hours](https://knowledge.kantata.com/hc/en-us/articles/360004619334-Project-Completion-Estimates) for the project or task when it is completed, up to 2 decimal places (e.g. 82.25). Values can also be negative (e.g. -22.25). This updates during the course of a project or task, as hours are logged.
    - `hours_etc` number, float: The [estimated hours](https://knowledge.kantata.com/hc/en-us/articles/360004619334-Project-Completion-Estimates) until completion (`hours_eac` - `hours`) of the project or task, up to two decimal places (e.g. 53.25). Values can also be negative (e.g. -10.25).
    - `total_estimated_hours` number, float: The hours initially estimated for the project or task, up to 2 decimal places (e.g. 83.50). Values can also be negative (e.g. -12.25). This value does not change over the course of a project.
    - `total_hours_to_date` number, float: The total hours logged to date for the project or task, up to 2 decimal places (e.g. 32.25). Values can also be negative (e.g. -5.75).
    - `labor_type` string: The type of cost associated with the record. Valid values are `Labor` or `Non-Labor`.
    - `notes` string: This can be any extra information to note about the record.
    - `percent_complete` number, float: How much of the project or task is complete in decimal format, up to 2 places (e.g. 0.75). Values can also be negative (e.g. -.25).
    - `revenue_method` string: The name of the revenue recognition method selected for this project. The following options are available for the [early access feature Revenue Management](https://knowledge.kantata.com/hc/en-us/articles/38986877019803-Revenue-Management-Early-Access): `Time & Materials`, `Time and Materials (Capped)`, `% Complete (Hours)`, and `% Complete (Cost)`.
    - `role_id` integer: The ID of the role associated with the record.
    - `service_type` string: This can be an organization-specific category of services that is related to the record (e.g. Branding, Campaigns, Photography, etc.).
    - `status` string: The status of the record. Valid values: `Draft`, `Pending Approval`, `Approved`, `Cancelled`.
    - `story_id` integer: The ID of the task related to the record.
    - `user_id` integer: The ID of the user associated with the record (e.g. who created the record, who the record was created for, etc.).
    - `external_reference` object: Typically populated programmatically by a third party system via an integration, this is an optional object that holds data from an external system. It connects objects in an external system with objects in Kantata OX (for example, to connect a Jira issue to a Kantata OX Project).
      - `service_name` string, required: The provider name of the integration. If you are adding multiple external references to the same object, the `service_name` must be unique.
      - `service_model` string, required: The object type of the external object this external reference belongs to.
      - `service_model_ref` string, required: The object ID of the external object this external reference belongs to.
      - `status` string: The status of the integration. Options are `successful`, `pending`, or `failed`.
      - `external_message` string: The message on the external object.
      - `external_link` string: The link to the external object.
      - `external_status` string: The status of the external object in the external system.
      - `locked` boolean: Whether the subject is locked.

## Response `200`

Project Accounting Records 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
  - `project_accounting_records` object
  - `external_references` object
  - `workspaces` object
  - `stories` object
  - `roles` object
  - `users` 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)