---
title: "Save one or many stored field values on one Hive contact, by field id or by name. Send one field and its value, or fields for up to 20 at once. Every value is checked before any is saved; retrying the same request finishes a partly saved batch without saving anything twice."
method: POST
path: "/api/v1/tools/update_contact"
---

# Save one or many stored field values on one Hive contact, by field id or by name. Send one field and its value, or fields for up to 20 at once. Every value is checked before any is saved; retrying the same request finishes a partly saved batch without saving anything twice.

`POST /api/v1/tools/update_contact`

## Request

- Base URL: `https://hivepublish.com`
- URL: `https://hivepublish.com/api/v1/tools/update_contact`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `contactId` string, required: The Hive contact identity.
  - `fieldId` string: The contact field to set.
  - `fieldName` string: The field’s key or name, instead of fieldId.
  - `value` union: The value to store in the field.
    - string
    - number
    - boolean
  - `fields` object[]: Up to 20 fields to set in one call, instead of one field and value.
    - `fieldId` string: The contact field to set.
    - `fieldName` string: The field’s key or name, instead of fieldId.
    - `value` union, required: The value to store.
      - string
      - number
      - boolean
  - `verified` boolean: Mark this value as verified.
  - `updatePolicy` 'replace' | 'if_empty' | 'replace_unverified': What to do when a value is already stored. Defaults to replace_unverified.

## Response `200`

Tool result

- ToolResult
  - `data` unknown, required
  - `meta` object, required
    - `tool` string
    - `workspaceId` string, uuid

## Other responses

- `400`: Invalid input
- `401`: Missing or invalid credential
- `403`: Missing workspace scope, role permission, or plan entitlement
- `409`: Idempotency conflict, replay, or request still in progress
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/hivepublish/apis/hive-developer-api.md) · [All operations](https://skmtc.dev/hivepublish/apis/hive-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hivepublish/apis/hive-developer-api/revisions/b440c763583e?raw)