---
title: "Save field configurations for an employer"
method: PUT
path: "/v1/employers/{employerId}/field-configurations"
tags: ["Employers"]
---

# Save field configurations for an employer

`PUT /v1/employers/{employerId}/field-configurations`

Saves integration-sourced additional field configurations for the specified employer. Replaces all existing integration-sourced templates. User-defined templates are preserved. Configurations that collide with existing user-defined templates are skipped.

## Path parameters

- `employerId` string, required

## Request body

- object
  - `configurations` object[], required
    - `key` string, required
    - `name` string, required
    - `source` string, required
    - `entity` 'order' | 'employee', required
    - `fieldType` 'text' | 'discrete', required
    - `discreteValues` object[]
      - `value` string, required
      - `sortOrder` integer, required
    - `active` boolean
    - `required` boolean

## Response `200`

Default Response

- object
  - `success` boolean, required
  - `count` integer, required
  - `skippedNames` string[], required

## Other responses

- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/bluehive-health/apis/bluehive-api.md) · [All operations](https://skmtc.net/bluehive-health/apis/bluehive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluehive-health/bluehive-api/revisions/ae97a9add0ba/schema)