---
title: "Create or update one or multiple entities."
method: POST
path: "/contacts/push"
tags: ["Contact Controller"]
---

# Create or update one or multiple entities.

`POST /contacts/push`

A uuid will be generated for any entity that doesn't have one yet. Posting entities without uuid multiple times will also create them multiple times.

## Response `207`

Array of responses, matching the posted array of entities. Provides an HTML status code for every entity and an optional body (e.g. a string with an error message).

- PostResponse[]
  - `body` object
  - `statusCode` integer

## Other responses

- `default` — When the request body has one or no entry. The status code of the response entry matches the response code and may have an optional body (e.g. a string with an error message).

## Changes

- **2026-07-31** `e777756d4099` — 4 info
  - added the new optional request property `items/epiData/clusterIdentifier`
  - added the new `NOT_APPLICABLE` enum value to the request property `items/epiData/clusterType`
  - added the new `RESPIRATORY_DROPLET` enum value to the request property `items/epiData/exposures/items/exposureCategory`
  - added the new `UNKNOWN` enum value to the request property `items/epiData/clusterType`
- **2026-07-30** `2fcf2b3dfea9` — 4 info
  - added the new optional request property `items/postpartum`
  - added the new optional request property `items/pregnant`
  - added the new optional request property `items/trimester`
  - added the new `MUMPS` enum value to the request property `items/disease`
- **2026-07-30** `7bd7fce3471f` — 1 info
  - added the new optional request property `items/healthConditions/highIronLevel`
- **2026-07-28** `bd9d5fd9bada` — 1 info
  - added the new `YERSINIOSIS` enum value to the request property `items/disease`
- **2026-07-28** `466b14ae6e00` — 6 info
  - added the new optional request property `items/epiData/contactWithSexWorker`
  - added the new optional request property `items/epiData/motherCitizenship`
  - added the new optional request property `items/epiData/motherCountryOfBirth`
  - added the new optional request property `items/epiData/probableRouteOfTransmission`
  - …2 more

[Full history](https://skmtc.dev/sormas-foundation/apis/sormas-rest-api/changes/contacts/push/post.md)

---

[API](https://skmtc.dev/sormas-foundation/apis/sormas-rest-api.md) · [All operations](https://skmtc.dev/sormas-foundation/apis/sormas-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sormas-foundation/sormas-rest-api/revisions/de257737a948/schema)