GET /rest/v1.1/companies/{company_id}/custom_field_definitions

Return a list of Custom Field Definitions for a given company.

Servers

Path parameters

Name Type Required Description
company_id Integer Yes

Unique identifier for the company.

Request headers

Name Type Required Description
Procore-Company-Id Integer Yes

Unique company identifier associated with the Procore User Account.

Query parameters

Name Type Required Description
page Integer No

Page

tool_name String No

The name of the company/project level tool that is allowed read permissions to custom field definitions.

Possible values:

  • "timesheets"
  • "admin"
per_page Integer No

Items per page, default: 100, max: 100

filterswith_label String No

Return custom field definitions that label contains text

sort String No

Direction (asc/desc) can be controlled by the presence or absence of '-' before the sort parameter.

Possible values:

  • "label"
  • "created_at"
includes_configurable_field_sets_count Boolean No

If true, response will include the number of field sets using item (custom field).

Default value: false

filtersid[] Array No

return custom field definitions that are filtered on an array of ID's. Example: filters[id]=[1,2]

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. 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.
  3. Click Test request to test run your request to the API and see the API's response.