POST /rest/v1.1/projects/{project_id}/bid_packages/{bid_package_id}/bid_forms/bulk_create

Creates multiple Bid Forms in one request

Servers

Path parameters

Name Type Required Description
project_id Integer Yes

Unique identifier for the project.

bid_package_id Integer Yes

Bid Package ID

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.

Query parameters

Name Type Required Description
completion_mode String No

Whether to update what can be or nothing if one can not be updated. Defaults to "all_or_nothing"

Valid values:

  • "atomic"
  • "all_or_nothing"

Request body fields

Name Type Required Description
bid_forms[] Array Yes
bid_forms[].lock_unit_fields_alternates Boolean No

Lock unit fields for all alternate items. Must be sent explicitly (no inheritance from bid package). Defaults to false if not provided.

Default value: false

bid_forms[].proposal_id Integer No

Proposal ID

bid_forms[].lock_quantity_fields_base_bid Boolean No

Lock quantity fields for all base bid items. Must be sent explicitly (no inheritance from bid package). Defaults to false if not provided.

Default value: false

bid_forms[].lock_quantity_fields_alternates Boolean No

Lock quantity fields for all alternate items. Must be sent explicitly (no inheritance from bid package). Defaults to false if not provided.

Default value: false

bid_forms[].title String Yes

Bid Form Title

bid_forms[].lock_unit_fields_base_bid Boolean No

Lock unit fields for all base bid items. Must be sent explicitly (no inheritance from bid package). Defaults to false if not provided.

Default value: false

bid_forms[].alternates[] Array No

Alternate bids

bid_forms[].alternates[].bid_form_items[] Array No

Bid Form Items

bid_forms[].alternates[].bid_form_items[].description String No

Bid Form Item Description

bid_forms[].alternates[].bid_form_items[].layer_id Integer No

ID of the Layer in the Estimate

bid_forms[].alternates[].bid_form_items[].locked_quantity Number No

Locked quantity value that cannot be changed by bidders when submitting bids

bid_forms[].alternates[].bid_form_items[].subject String No

Subject for Plain Text Items.

bid_forms[].alternates[].bid_form_items[].position Integer No

Position

bid_forms[].alternates[].bid_form_items[].estimated_unit_of_measure String No

Unit of Measure from the Layer of an Estimate

bid_forms[].alternates[].bid_form_items[].locked_unit_of_measure String No

Locked unit of measure that cannot be changed by bidders when submitting bids

bid_forms[].alternates[].bid_form_items[].item_type String No

Bid Form Items can be of various types. This property does determine which one is used.

Valid values:

  • "cost_code"
  • "plain_text"
bid_forms[].alternates[].bid_form_items[].estimated_unit_cost Number No

Estimated Unit from the Layer of an Estimate

bid_forms[].alternates[].bid_form_items[].response_type String No

Bid Form Items can have various response types. This property determines which one is used.

Valid values:

  • "unit"
  • "include_exclude"
  • "amount"
bid_forms[].alternates[].bid_form_items[].estimated_amount Number No

Amount from the Layer of an Estimate

bid_forms[].alternates[].bid_form_items[].estimated_quantity Number No

Quantity from the Layer of an Estimate

bid_forms[].alternates[].bid_form_items[].cost_code_id Integer No

Cost Code ID

bid_forms[].alternates[].header Boolean No

Whether the item is a header or not

bid_forms[].alternates[].sub_sections[] Array No

Sub Sections

bid_forms[].alternates[].sub_sections[].bid_form_items[] Array No

Bid Form Items

bid_forms[].alternates[].sub_sections[].bid_form_items[].description String No

Bid Form Item Description

bid_forms[].alternates[].sub_sections[].bid_form_items[].layer_id Integer No

ID of the Layer in the Estimate

bid_forms[].alternates[].sub_sections[].bid_form_items[].locked_quantity Number No

Locked quantity value that cannot be changed by bidders when submitting bids

bid_forms[].alternates[].sub_sections[].bid_form_items[].subject String No

Subject for Plain Text Items.

bid_forms[].alternates[].sub_sections[].bid_form_items[].position Integer No

Position

bid_forms[].alternates[].sub_sections[].bid_form_items[].estimated_unit_of_measure String No

Unit of Measure from the Layer of an Estimate

bid_forms[].alternates[].sub_sections[].bid_form_items[].locked_unit_of_measure String No

Locked unit of measure that cannot be changed by bidders when submitting bids

bid_forms[].alternates[].sub_sections[].bid_form_items[].item_type String No

Bid Form Items can be of various types. This property does determine which one is used.

Valid values:

  • "cost_code"
  • "plain_text"
bid_forms[].alternates[].sub_sections[].bid_form_items[].estimated_unit_cost Number No

Estimated Unit from the Layer of an Estimate

bid_forms[].alternates[].sub_sections[].bid_form_items[].response_type String No

Bid Form Items can have various response types. This property determines which one is used.

Valid values:

  • "unit"
  • "include_exclude"
  • "amount"
bid_forms[].alternates[].sub_sections[].bid_form_items[].estimated_amount Number No

Amount from the Layer of an Estimate

bid_forms[].alternates[].sub_sections[].bid_form_items[].estimated_quantity Number No

Quantity from the Layer of an Estimate

bid_forms[].alternates[].sub_sections[].bid_form_items[].cost_code_id Integer No

Cost Code ID

bid_forms[].alternates[].sub_sections[].title String No

Sub Section Title

bid_forms[].alternates[].title String No

Alternate Bid Form Item Title

bid_forms[].alternates[].position Integer No

Position

bid_forms[].base_bid[] Array No

Base Bids

bid_forms[].base_bid[].bid_form_items[] Array No

Bid Form Items

bid_forms[].base_bid[].bid_form_items[].description String No

Bid Form Item Description

bid_forms[].base_bid[].bid_form_items[].layer_id Integer No

ID of the Layer in the Estimate

bid_forms[].base_bid[].bid_form_items[].locked_quantity Number No

Locked quantity value that cannot be changed by bidders when submitting bids

bid_forms[].base_bid[].bid_form_items[].subject String No

Subject for Plain Text Items.

bid_forms[].base_bid[].bid_form_items[].position Integer No

Position

bid_forms[].base_bid[].bid_form_items[].estimated_unit_of_measure String No

Unit of Measure from the Layer of an Estimate

bid_forms[].base_bid[].bid_form_items[].locked_unit_of_measure String No

Locked unit of measure that cannot be changed by bidders when submitting bids

bid_forms[].base_bid[].bid_form_items[].item_type String No

Bid Form Items can be of various types. This property does determine which one is used.

Valid values:

  • "cost_code"
  • "plain_text"
bid_forms[].base_bid[].bid_form_items[].estimated_unit_cost Number No

Estimated Unit from the Layer of an Estimate

bid_forms[].base_bid[].bid_form_items[].response_type String No

Bid Form Items can have various response types. This property determines which one is used.

Valid values:

  • "unit"
  • "include_exclude"
  • "amount"
bid_forms[].base_bid[].bid_form_items[].estimated_amount Number No

Amount from the Layer of an Estimate

bid_forms[].base_bid[].bid_form_items[].estimated_quantity Number No

Quantity from the Layer of an Estimate

bid_forms[].base_bid[].bid_form_items[].cost_code_id Integer No

Cost Code ID

bid_forms[].base_bid[].header Boolean No

Whether the item is a header or not

bid_forms[].base_bid[].sub_sections[] Array No

Sub Sections

bid_forms[].base_bid[].sub_sections[].bid_form_items[] Array No

Bid Form Items

bid_forms[].base_bid[].sub_sections[].bid_form_items[].description String No

Bid Form Item Description

bid_forms[].base_bid[].sub_sections[].bid_form_items[].layer_id Integer No

ID of the Layer in the Estimate

bid_forms[].base_bid[].sub_sections[].bid_form_items[].locked_quantity Number No

Locked quantity value that cannot be changed by bidders when submitting bids

bid_forms[].base_bid[].sub_sections[].bid_form_items[].subject String No

Subject for Plain Text Items.

bid_forms[].base_bid[].sub_sections[].bid_form_items[].position Integer No

Position

bid_forms[].base_bid[].sub_sections[].bid_form_items[].estimated_unit_of_measure String No

Unit of Measure from the Layer of an Estimate

bid_forms[].base_bid[].sub_sections[].bid_form_items[].locked_unit_of_measure String No

Locked unit of measure that cannot be changed by bidders when submitting bids

bid_forms[].base_bid[].sub_sections[].bid_form_items[].item_type String No

Bid Form Items can be of various types. This property does determine which one is used.

Valid values:

  • "cost_code"
  • "plain_text"
bid_forms[].base_bid[].sub_sections[].bid_form_items[].estimated_unit_cost Number No

Estimated Unit from the Layer of an Estimate

bid_forms[].base_bid[].sub_sections[].bid_form_items[].response_type String No

Bid Form Items can have various response types. This property determines which one is used.

Valid values:

  • "unit"
  • "include_exclude"
  • "amount"
bid_forms[].base_bid[].sub_sections[].bid_form_items[].estimated_amount Number No

Amount from the Layer of an Estimate

bid_forms[].base_bid[].sub_sections[].bid_form_items[].estimated_quantity Number No

Quantity from the Layer of an Estimate

bid_forms[].base_bid[].sub_sections[].bid_form_items[].cost_code_id Integer No

Cost Code ID

bid_forms[].base_bid[].sub_sections[].title String No

Sub Section Title

bid_forms[].base_bid[].title String No

Base Bid Form Item Title

bid_forms[].base_bid[].position Integer No

Position

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.