Fieldinsight Public API
    • Introduction
    • OAuth
    • Personal API Keys
    • Rate limits
    • Contacts
      • Get contacts
        GET
      • Create contact
        POST
      • Upsert contact
        PUT
      • Patch contact
        PATCH
      • Remove contact
        DELETE
    • Customers
      • Create customer
        POST
      • Get customers
        GET
      • Upsert customer
        PUT
      • Patch customer
        PATCH
      • Remove customer
        DELETE
      • Add contact to customer
        POST
      • Remove contact from customer
        DELETE
    • Sites
      • Create site
        POST
      • Get sites
        GET
      • Upsert site
        PUT
      • Patch site
        PATCH
      • Remove site
        DELETE
      • Add site to project
        POST
      • Add contact to site
        POST
      • Remove contact from site
        DELETE
    • Inventory
      • Get items
        GET
      • Create item
        POST
      • Patch item
        PATCH
      • Upsert item
        PUT
      • Remove item
        DELETE
      • Update stock
        PUT
      • Adjust stock
        PUT
    • Invoices
      • List Invoices
      • Create Invoice
      • Update Invoice
      • Delete Invoice
      • Set export status
      • Get Invoice PDF
      • Get payments
      • Add payment
    • Payment Methods
      • Upsert Payment Method
      • List Payment Methods
      • Delete Payment Method
    • Payment Terms
      • Upsert Payment Term
      • List Payment Terms
      • Delete Payment Term
    • Business Entities
      • Upsert Business Entity
      • List Business Entities
      • Delete Business Entity
    • Jobs
      • Get jobs
      • Create job
      • Update job
    • Item Classes
      • List Item Classes
      • Upsert Item Class
      • Delete Item Class
    • Cost Codes
      • Upsert Cost Code
      • List Cost Codes
      • Delete Cost Code
    • Pay Items
      • Upsert Pay Item
      • List Pay Items
      • Delete Pay Item
    • Account Groups
      • Upsert Account Group
      • List Account Groups
      • Delete Account Group
    • Units of Measure
      • Upsert Unit Of Measure
      • List Unit Of Measures
      • Delete Unit Of Measure
    • Business Divisions
      • Upsert Business Division
      • List Business Divisions
      • Delete Business Division
    • Warehouses
      • Upsert Part Item Warehouse Location
      • List Part Item Warehouse Locations
      • Delete Part Item Warehouse Location
    • Warehouse Positions
      • Upsert Part Item Warehouse Position
      • List Part Item Warehouse Positions
      • Delete Part Item Warehouse Position
    • Users
      • Get users
    • Projects
      • Get projects
      • Create project
      • Patch project
      • Upsert project
      • Remove project
      • Add account group
      • Remove account group
    • Project Types
      • Upsert Project Type
      • List Project Types
      • Delete Project Type
    • Job Statuses
      • Get items
    • Job Types
      • Get list
    • Workflows
      • Get list
    • Asset Types
      • Upsert Asset Type
      • List Asset Types
      • Delete Asset Type
    • Asset Categories
      • Upsert Asset Type Category
      • List Asset Type Categories
      • Delete Asset Type Category
    • Asset Category Groups
      • Upsert Asset Category Group
      • List Asset Category Groups
      • Delete Asset Category Group
    • Asset Models
      • Upsert Asset Model
      • List Asset Models
      • Delete Asset Model
    • Assets
      • Get assets
      • Create asset
      • Patch asset
      • Upsert asset
      • Remove asset
    • Inventory Transactions
      • Get transactions
    • To-do Lists
      • Create task
      • Get tasks
      • Update task
      • Remove task
    • To-dos
      • Create sub task
      • Get sub tasks
      • Update sub task
      • Remove sub task
    • To-do Types
      • Upsert Todo Type
      • List Todo Types
      • Delete Todo Type
    • To-do Statuses
      • Upsert Todo Status
      • List Todo Statuses
      • Delete Todo Status
    • To-do Priorities
      • Upsert Todo Priority
      • List Todo Priorities
      • Delete Todo Priority
    • Quotes
      • List Quotes
      • Create Quote
      • Update Quote
      • Delete Quote
      • Set export status
      • Get Quote PDF
    • Reports
      • List Reports
      • Create Report
      • Update Report
      • Delete Report
      • Set export status
      • Get Report PDF
    • Purchase Orders
      • List Purchase Orders
      • Create Purchase Order
      • Update Purchase Order
      • Delete Purchase Order
      • Set export status
      • Get Purchase Order PDF
    • Customer Statuses
      • Upsert Customer Status
      • List Customer Statuses
      • Delete Customer Status
    • Schemas
      • AccountGroupInput
      • AccountGroupListItem
      • AccountGroupListQuery
      • AssetCategoryExcerpt
      • AssetCategoryGroupInput
      • AssetCategoryGroupListItem
      • AssetCategoryGroupListQuery
      • AssetCustomEntryInput
      • AssetDeleteQuery
      • AssetInput
      • AssetListItem
      • AssetListQuery
      • AssetModelExcerpt
      • AssetModelInput
      • AssetModelListItem
      • AssetModelListQuery
      • AssetPatchInput
      • AssetSaveOutput
      • AssetTypeCategoryInput
      • AssetTypeCategoryListItem
      • AssetTypeCategoryListQuery
      • AssetTypeExcerpt
      • AssetTypeInput
      • AssetTypeListItem
      • AssetTypeListQuery
      • BusinessDivisionInput
      • BusinessDivisionListItem
      • BusinessDivisionListQuery
      • BusinessEntityInput
      • BusinessEntityListItem
      • BusinessEntityListQuery
      • ContactCustomEntryInput
      • ContactDeleteQuery
      • ContactExcerpt
      • ContactInput
      • ContactListQuery
      • ContactPatchInput
      • ContactSaveOutput
      • CostCodeInput
      • CostCodeListItem
      • CostCodeListQuery
      • CreateJobOutput
      • CustomEntryOutput
      • CustomerCustomEntryInput
      • CustomerDeleteQuery
      • CustomerExtraContactInput
      • CustomerExtraContactRemoveInput
      • CustomerListItem
      • CustomerListQuery
      • CustomerPatchInput
      • CustomerSaveOutput
      • CustomerStatusInput
      • CustomerStatusListItem
      • CustomerStatusListQuery
      • CustomerWithContactInput
      • DocumentCreateInput
      • DocumentDeleteQuery
      • DocumentJobExcerpt
      • DocumentLineItemInput
      • DocumentLineItemOutput
      • DocumentListQuery
      • DocumentSectionInput
      • DocumentSectionOutput
      • DocumentUpdateInput
      • ExportErrorInput
      • ExportResultInput
      • InvoiceListItem
      • InvoiceListQuery
      • InvoiceUpdateInput
      • ItemClassExcerpt
      • ItemClassInput
      • ItemClassListItem
      • ItemClassListQuery
      • ItemClassRefInput
      • ItemCreateInput
      • ItemDeleteQuery
      • ItemExcerpt
      • ItemIdOutput
      • ItemIdRootOutput
      • ItemInput
      • ItemListItem
      • ItemListQuery
      • ItemPatchInput
      • JobCustomEntryInput
      • JobInput
      • JobListQuery
      • JobStatusListItem
      • JobStatusListQuery
      • JobTypeListItem
      • JobTypeListQuery
      • LineItemLocationOutput
      • ListResponse[AccountGroupListItem]
      • ListResponse[AssetCategoryGroupListItem]
      • ListResponse[AssetListItem]
      • ListResponse[AssetModelListItem]
      • ListResponse[AssetTypeCategoryListItem]
      • ListResponse[AssetTypeListItem]
      • ListResponse[BusinessDivisionListItem]
      • ListResponse[BusinessEntityListItem]
      • ListResponse[ContactListItem]
      • ListResponse[CostCodeListItem]
      • ListResponse[CustomerListItem]
      • ListResponse[CustomerStatusListItem]
      • ListResponse[InvoiceListItem]
      • ListResponse[ItemClassListItem]
      • ListResponse[ItemListItem]
      • ListResponse[JobListItem]
      • ListResponse[JobStatusListItem]
      • ListResponse[JobTypeListItem]
      • ListResponse[PartItemWarehouseLocationListItem]
      • ListResponse[PartItemWarehousePositionListItem]
      • ListResponse[PayItemListItem]
      • ListResponse[PaymentListItem]
      • ListResponse[PaymentMethodListItem]
      • ListResponse[PaymentTermListItem]
      • ListResponse[ProjectListItem]
      • ListResponse[ProjectTypeListItem]
      • ListResponse[PurchaseOrderListItem]
      • ListResponse[QuoteListItem]
      • ListResponse[ReportListItem]
      • ListResponse[SiteListItem]
      • ListResponse[TodoListItem]
      • ListResponse[TodoListListItem]
      • ListResponse[TodoPriorityListItem]
      • ListResponse[TodoStatusListItem]
      • ListResponse[TodoTypeListItem]
      • ListResponse[TransactionListItem]
      • ListResponse[UnitOfMeasureListItem]
      • ListResponse[UserListItem]
      • ListResponse[WorkflowListItem]
      • OptionRemoveRequest
      • OptionUpsertOutput
      • PartItemWarehouseLocationListItem
      • PartItemWarehouseLocationListQuery
      • PartItemWarehousePositionListItem
      • PartItemWarehousePositionListQuery
      • PayItemInput
      • PayItemListItem
      • PayItemListQuery
      • PaymentInput
      • PaymentListItem
      • PaymentListQuery
      • PaymentMethodInput
      • PaymentMethodListItem
      • PaymentMethodListQuery
      • PaymentMethodOutput
      • PaymentOutput
      • PaymentTermListQuery
      • PaymentTermSchema
      • ProjectAccountGroupInput
      • ProjectDeleteQuery
      • ProjectInput
      • ProjectListItem
      • ProjectListQuery
      • ProjectPatchInput
      • ProjectSaveOutput
      • ProjectTypeExcerpt
      • ProjectTypeInput
      • ProjectTypeListItem
      • ProjectTypeListQuery
      • PurchaseOrderExcerpt
      • PurchaseOrderListItem
      • PurchaseOrderUpdateInput
      • QuoteListItem
      • RecipientOutput
      • ReportListItem
      • SiteCustomEntryInput
      • SiteDeleteQuery
      • SiteExtraContactInput
      • SiteExtraContactRemoveInput
      • SiteListQuery
      • SitePatchInput
      • SiteProjectInput
      • SiteSaveOutput
      • SiteWithContactInput
      • StockAdjustInput
      • StockItemRefInput
      • StockUpdateInput
      • SupplierExcerpt
      • TodoCreateInput
      • TodoDeleteQuery
      • TodoListCreateInput
      • TodoListDeleteQuery
      • TodoListExcerpt
      • TodoListItem
      • TodoListListItem
      • TodoListListQuery
      • TodoListPatchInput
      • TodoListQuery
      • TodoListSaveOutput
      • TodoPatchInput
      • TodoPriorityExcerpt
      • TodoPriorityInput
      • TodoPriorityListItem
      • TodoPriorityListQuery
      • TodoSaveOutput
      • TodoStatusExcerpt
      • TodoStatusInput
      • TodoStatusListItem
      • TodoStatusListQuery
      • TodoTypeExcerpt
      • TodoTypeInput
      • TodoTypeListItem
      • TodoTypeListQuery
      • TransactionListItem
      • TransactionListQuery
      • TransactionType
      • UnitOfMeasureExcerpt
      • UnitOfMeasureInput
      • UnitOfMeasureListItem
      • UnitOfMeasureListQuery
      • UnitOfMeasureRefInput
      • UserListItem
      • UserListQuery
      • WarehouseExcerpt
      • WarehouseInput
      • WarehousePositionInput
      • WarehousePositionRefInput
      • WarehouseRefInput
      • WorkflowListItem
      • WorkflowListQuery
      • ApiError
      • ApiValidationErrors
      • ApiValidationErrorDetail

    Personal API Keys

    Personal API keys allow users to securely access the FieldInsight Public API without needing to complete an OAuth authorization flow each time they make a request. They are intended for server-to-server integrations, automation scripts and other trusted use cases where a user or developer needs direct API access.

    What is a personal API key?#

    A personal API key is a private secret code that allows an application or script to access an API on behalf of a specific user. It works like a digital password for API requests — once the key is added to the request, the system knows who is making the request and what data or actions they are allowed to access. Users usually create personal API keys manually in their account settings and can revoke them at any time if needed.
    You should treat your API key like a password. Anyone with access to the key may be able to access your FieldInsight data through the API.

    Generating a personal API key#

    To create a personal API key:
    1.
    Sign in to FieldInsight.
    2.
    Go to Personal API keys.
    3.
    Create a new API key.
    4.
    Copy the key and store it securely.
    The key may only be shown once, so make sure you save it in a secure password manager or secrets manager.

    Making an API request#

    Include your personal API key in the request headers when calling the Public API.
    Example:
    Or using cURL:
    Replace YOUR_PERSONAL_API_KEY with your actual key.

    Keeping your API key secure#

    To protect your account:
    Do not share your API key publicly.
    Do not commit it to source control.
    Store it in environment variables or a secrets manager.
    Rotate the key if you think it has been exposed.
    Delete keys that are no longer used.
    Example using an environment variable:
    Then use it in a request:

    Revoking or rotating a key#

    If a key is no longer needed, or if it may have been exposed, revoke it from the API access settings.
    To rotate a key:
    1.
    Create a new personal API key.
    2.
    Update your application or script to use the new key.
    3.
    Test that API requests still work.
    4.
    Revoke the old key.
    Modified at 2026-05-08 23:32:10
    Previous
    OAuth
    Next
    Rate limits
    Built with