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

Create a Bid Form for a Bid Package. A bid form is needed to submit a bid, since the bid will be made against the bid form.

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.

Request body fields

Name	Type	Required	Description
`title`	String	Yes	Bid Form Title
`alternates[]`	Array	No	Alternate bids
`alternates[].bid_form_items[]`	Array	No	Bid Form Items
`alternates[].bid_form_items[].description`	String	No	Bid Form Item Description
`alternates[].bid_form_items[].subject`	String	No	Subject for Plain Text Items.
`alternates[].bid_form_items[].item_type`	String	No	Bid Form Items can be of various types. This property does determine which one is used. Possible values: `"cost_code"` `"plain_text"`
`alternates[].bid_form_items[].position`	Integer	No	Position
`alternates[].bid_form_items[].response_type`	String	No	Bid Form Items can have various response types. This property determines which one is used. Possible values: `"unit"` `"include_exclude"` `"amount"`
`alternates[].bid_form_items[].cost_code_id`	Integer	No	Cost Code ID
`alternates[].header`	Boolean	No	Whether the item is a header or not
`alternates[].sub_sections[]`	Array	No	Sub Sections
`alternates[].sub_sections[].bid_form_items[]`	Array	No	Bid Form Items
`alternates[].sub_sections[].bid_form_items[].description`	String	No	Bid Form Item Description
`alternates[].sub_sections[].bid_form_items[].subject`	String	No	Subject for Plain Text Items.
`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. Possible values: `"cost_code"` `"plain_text"`
`alternates[].sub_sections[].bid_form_items[].position`	Integer	No	Position
`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. Possible values: `"unit"` `"include_exclude"` `"amount"`
`alternates[].sub_sections[].bid_form_items[].cost_code_id`	Integer	No	Cost Code ID
`alternates[].sub_sections[].title`	String	No	Sub Section Title
`alternates[].title`	String	No	Alternate Bid Form Item Title
`alternates[].position`	Integer	No	Position
`base_bid[]`	Array	No	Base Bids
`base_bid[].bid_form_items[]`	Array	No	Bid Form Items
`base_bid[].bid_form_items[].description`	String	No	Bid Form Item Description
`base_bid[].bid_form_items[].subject`	String	No	Subject for Plain Text Items.
`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. Possible values: `"cost_code"` `"plain_text"`
`base_bid[].bid_form_items[].position`	Integer	No	Position
`base_bid[].bid_form_items[].response_type`	String	No	Bid Form Items can have various response types. This property determines which one is used. Possible values: `"unit"` `"include_exclude"` `"amount"`
`base_bid[].bid_form_items[].cost_code_id`	Integer	No	Cost Code ID
`base_bid[].header`	Boolean	No	Whether the item is a header or not
`base_bid[].sub_sections[]`	Array	No	Sub Sections
`base_bid[].sub_sections[].bid_form_items[]`	Array	No	Bid Form Items
`base_bid[].sub_sections[].bid_form_items[].description`	String	No	Bid Form Item Description
`base_bid[].sub_sections[].bid_form_items[].subject`	String	No	Subject for Plain Text Items.
`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. Possible values: `"cost_code"` `"plain_text"`
`base_bid[].sub_sections[].bid_form_items[].position`	Integer	No	Position
`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. Possible values: `"unit"` `"include_exclude"` `"amount"`
`base_bid[].sub_sections[].bid_form_items[].cost_code_id`	Integer	No	Cost Code ID
`base_bid[].sub_sections[].title`	String	No	Sub Section Title
`base_bid[].title`	String	No	Base Bid Form Item Title
`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.