POST /rest/v1.1/projects/{project_id}/direct_costs

Create a new Direct Cost Item in the specified Project. The number of Line Items that can be sent in a single create request is limited to 100.

Servers

Path parameters

Name Type Required Description
project_id Integer Yes

Unique identifier for the project.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Procore-Company-Id Integer Yes

Unique company identifier associated with the Procore User Account.

Request body fields

Name Type Required Description
direct_cost Object Yes

Direct Cost Item object

direct_cost.vendor_id Integer Yes

Vendor ID

direct_cost.description String No

Description

direct_cost.payment_date String No

Payment Date

direct_cost.direct_cost_type String Yes

Type

Possible values:

  • "payroll"
  • "expense"
  • "invoice"
  • "subcontractor_invoice"
direct_cost.status String No

Status

Possible values:

  • "approved"
  • "pending"
  • "revise_and_resubmit"
  • "draft"
direct_cost.origin_data String No

Origin Data

direct_cost.terms String No

The agreed upon Terms for the date of payment

direct_cost.line_items[] Array No

Line items that should be assoicated with the direct cost item.

direct_cost.line_items[].manual_amount Number No

Amount

direct_cost.line_items[].direct_cost_id Integer No

Direct Cost ID

direct_cost.line_items[].description String No

Description

direct_cost.line_items[].wbs_code_id Integer Yes

WBS Code ID

direct_cost.line_items[].origin_id String No

Origin ID

direct_cost.line_items[].quantity Number No

Quantity of described item

direct_cost.line_items[].ref String No

The reference, if any, passed in upon item creation and is not persisted.

direct_cost.line_items[].uom String No

Unit of measure of the described item

Possible values:

  • "Any value present in the Company list of Units of Measure"
direct_cost.line_items[].unit_cost Number No

Unit cost of described item

direct_cost.line_items[].origin_data String No

Origin Data

direct_cost.invoice_number String Yes

Unique identifier for a Direct Cost Item of type invoice. Is required only if direct_cost_type is set to invoice.

direct_cost.origin_id String No

Origin ID

direct_cost.received_date String No

Received Date

direct_cost.direct_cost_date String No

Date

direct_cost.employee_id Integer No

ID of the Employee tied to the Direct Cost Item

attachments[] Array No

Direct Cost Item attachments. To upload attachments you must upload the entire payload as multipart/form-data content-type and specify each parameter as form-data together with attachments[] as files.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.