POST /rest/v1.1/projects/{project_id}/bid_packages/{bid_package_id}/bid_forms/bulk_create
Creates multiple Bid Forms in one request
Servers
- https://api.procore.com
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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
- Add HTTP Task to your workflow definition.
- 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.
- Click Test request to test run your request to the API and see the API's response.