Create Prime Change Order
create_prime_change_orderCreate a new prime change order in Procore for single or multi-tier projects. Specify project and contract IDs to initiate the change order.
Instructions
Create a new Prime Change Order. This endpoint currently only supports projects using 1 and 2 tier change order configurations. Use this to create a new Prime Contracts in Procore. Creates a new Prime Contracts and returns the created object on success (HTTP 201). Required parameters: project_id, contract_id. Procore API: Construction Financials > Prime Contracts. Endpoint: POST /rest/v1.0/projects/{project_id}/prime_change_orders
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| run_configurable_validations | No | Query string parameter — if true, validations are run for the corresponding Configurable Field Set. | |
| contract_id | Yes | JSON request body field — unique identifier for the contract. | |
| batch_id | No | JSON request body field — unique identifier for a change order batch. | |
| change_order_change_reason_id | No | JSON request body field — unique identifier for the change reason. | |
| location_id | No | JSON request body field — unique identifier for the location. | |
| designated_reviewer_id | No | JSON request body field — unique identifier for the designated reviewer. This field is only supported for single-tier projects. Behavior is undefined in multi-tier projects. | |
| received_from_id | No | JSON request body field — unique identifier for the received from entity. | |
| description | No | JSON request body field — the description for this Prime Contracts operation | |
| due_date | No | JSON request body field — due date in YYYY-MM-DD format | |
| paid_date | No | JSON request body field — the paid date in YYYY-MM-DD format | |
| invoiced_date | No | JSON request body field — the invoiced date in YYYY-MM-DD format | |
| title | No | JSON request body field — title of the Contract | |
| status | No | JSON request body field — the status for this Prime Contracts operation | |
| reference | No | JSON request body field — the reference for this Prime Contracts operation | |
| number | No | JSON request body field — number of the Change Order | |
| revision | No | JSON request body field — revision Number | |
| field_change | No | JSON request body field — the field change for this Prime Contracts operation | |
| signature_required | No | JSON request body field — whether a signature will be required for this Change Order | |
| signed_change_order_received_date | No | JSON request body field — signed Change Order Received Date | |
| schedule_impact_amount | No | JSON request body field — schedule impact in days | |
| executed | No | JSON request body field — whether or not the Change Order is executed | |
| private | No | JSON request body field — whether or not the Commitment Change Order is private | |
| paid | No | JSON request body field — whether or not the Commitment Change Order is paid | |
| reason | No | JSON request body field — reason for the change order | |
| custom_field_%{custom_field_definition_id} | No | JSON request body field — value of the custom field. The data type of the value passed in corresponds with the data_type of the Custom Field Definition. For a lov_entry data_type the value passed in should be the ID of one ... | |
| enable_ssov | No | JSON request body field — whether to enable SSOV on this Change Order. Only applicable to Commitment Change Orders. | |
| change_event_attachment_ids | No | JSON request body field — list of attachment IDs to attach. These must presently be associated with Change Events. | |
| attachment_ids | No | JSON request body field — existing attachments to preserve on the response | |
| drawing_revision_ids | No | JSON request body field — drawing Revisions to attach to the response | |
| file_version_ids | No | JSON request body field — file Versions to attach to the response |