Create Asset
create_asset_companyCreate a company asset in Procore using company, asset type, and status IDs. Returns the created asset with its new ID.
Instructions
Creates a new company asset with the provided details. company_id defaults to the value set by procore_set_config when omitted. Creates the asset 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, asset_type_id, asset_status_id. Procore API (v2.0): Core > Assets. Endpoint: POST /rest/v2.0/companies/{company_id}/assets
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| latitude | No | JSON request body field — latitude must be provided together with longitude, or both must be omitted.(only applicable for project asset) | |
| trade_id | No | JSON request body field — trade ID associated with the asset | |
| longitude | No | JSON request body field — longitude must be provided together with latitude, or both must be omitted.(only applicable for project asset) | |
| asset_code | No | JSON request body field — unique identifier for the asset (also referred to as asset_code in API). Must be unique at company level (case-insensitive). Optional when an active naming rule exists—the ID (code) will be auto-ge... | |
| asset_name | No | JSON request body field — name of the asset. | |
| company_id | Yes | URL path parameter — unique identifier for the company. | |
| description | No | JSON request body field — description of the asset | |
| location_id | No | JSON request body field — location ID where the asset is located (only applicable for project asset) | |
| asset_type_id | Yes | JSON request body field — asset type ID (primary key of the asset type). Must have Is Asset enabled for that type. | |
| custom_fields | No | JSON request body field — custom fields map. Key: 'custom\_field\_{id}'. Supported types: STRING (text), RICH_TEXT (HTML), BOOLEAN, DECIMAL, DATETIME (ISO 8601), LOV_ENTRY ({id, name}), LOV_ENTRIES ([{id, name}]). Field def... | |
| Accept-Language | No | JSON request body field — locale for localized response messages (for example: en, fr-FR, pseudo) | |
| asset_status_id | Yes | JSON request body field — unique identifier of the asset status | |
| parent_asset_id | No | JSON request body field — parent asset ID. Optional. When provided, creates a parent-child relationship. The parent must exist, belong to the same company, and be in the same asset type hierarchy. | |
| profile_image_id | No | JSON request body field — profile image FAS ID |