Create Company Vendor Insurance
create_company_vendor_insuranceCreate a new insurance record for a Procore company vendor using company and vendor IDs, with optional policy details, and get the new record's ID.
Instructions
Create a new Insurance associated with the specified Company Vendor. Pass the record's fields as top-level arguments — they are nested under "insurance" in the request payload for you. company_id defaults to the value set by procore_set_config when omitted, and vendor_id must identify an existing parent record — resolve it with the matching list tool first. Creates the company vendor insurance and returns it with its new id (HTTP 201); calling it again creates another record. Failures come back as an error payload carrying the HTTP status — commonly 401 when the token has expired, 403 without tool permission, and 404 when an id does not resolve. Required parameters: company_id, vendor_id. Procore API: Core > Directory. Endpoint: POST /rest/v1.0/companies/{company_id}/vendors/{vendor_id}/insurances
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | JSON request body field — provider name | |
| limit | No | JSON request body field — the limit for this Directory operation | |
| notes | No | JSON request body field — the notes for this Directory operation | |
| exempt | No | JSON request body field — exempt status | |
| status | No | JSON request body field — the status for this Directory operation | |
| origin_id | No | JSON request body field — unique identifier of the origin | |
| vendor_id | Yes | URL path parameter — unique identifier of the vendor | |
| company_id | Yes | URL path parameter — unique identifier for the company. | |
| origin_data | No | JSON request body field — the origin data for this Directory operation | |
| info_received | No | JSON request body field — information received (or not) | |
| policy_number | No | JSON request body field — the policy number for this Directory operation | |
| effective_date | No | JSON request body field — the effective date in YYYY-MM-DD format | |
| insurance_sets | No | JSON request body field — the insurance sets for this Directory operation | |
| insurance_type | No | JSON request body field — the insurance type for this Directory operation | |
| expiration_date | No | JSON request body field — the expiration date in YYYY-MM-DD format | |
| division_template | No | JSON request body field — the division template for this Directory operation | |
| additional_insured | No | JSON request body field — additional Individuals and/or Companies Insured | |
| enable_expired_insurance_notifications | No | JSON request body field — enable/Disable expired insurance notifications |