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

Create a new Direct Cost Item in the specified Project.

Note: In addition to the values documented below for the direct_cost_type attribute, an enum value of subcontractor_invoice is also allowed. To enable this feature in the Procore web application, contact apisupport@procore.com.

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
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.

item Object Yes

Direct Cost Item object

item.vendor_id Integer Yes

Vendor ID

item.description String No

Description

item.payment_date String No

Payment Date

item.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.

item.origin_id String No

Origin ID

item.direct_cost_type String Yes

Type

Possible values:

  • "payroll"
  • "expense"
  • "invoice"
item.received_date String No

Received Date

item.direct_cost_date String No

Date

item.employee_id Integer No

ID of the Employee tied to the Direct Cost Item

item.status String No

Status

Possible values:

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

Origin Data

item.terms String No

The agreed upon Terms for the date of payment

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.