---
title: "Changes to Create or upsert contacts (no campaign required)"
method: POST
path: "/contacts"
---

# Changes to Create or upsert contacts (no campaign required)

`POST /contacts`

> Every recorded change to this operation, newest first.
> 40 revisions in range; 1 not diffed.

## Timeline

Changed in 8 of 40 revisions.

- **2026-10-22** `549f4adbbfcf`: 3 info
- **2026-10-22** `bdaed6984b20`: 1 warning
- **2026-10-03** `e8a9550eb535`: 1 warning, 2 info
- **2026-09-17** `71b5dd686f80`: 1 breaking, 3 warning
- **2026-08-28** `62bf7284843d`: 1 breaking
- **2026-08-27** `d5f1141f87e3`: 11 warning
- **2026-08-19** `1ad91026000b`: 10 breaking, 5 info
- **2026-08-05** `3caf12036b26`: 1 breaking

## Changes

- **2026-10-22** `549f4adbbfcf`: 3 info
  - added the optional property `contacts/items/fit` to the response with the `201` status
  - added the optional property `contacts/items/run` to the response with the `201` status
  - added the optional property `contacts/items/whyNow` to the response with the `201` status
- **2026-10-22** `bdaed6984b20`: 1 warning
  - removed the optional property `_meta` from the response with the `201` status
- **2026-10-03** `e8a9550eb535`: 1 warning, 2 info
  - removed the request property `contacts/items/lifecycleStage`
  - the request property `contacts/items/source` with a default value became required
  - added the new `inbound` enum value to the request property `contacts/items/source`
- **2026-09-17** `71b5dd686f80`: 1 breaking, 3 warning
  - removed the enum value `qualified` of the request property `contacts/items/lifecycleStage`
  - removed the request property `contacts/items/hotScore`
  - removed the request property `contacts/items/leadBrief`
  - removed the request property `contacts/items/qualificationNotes`
- **2026-08-28** `62bf7284843d`: 1 breaking
  - removed the required property `_meta/credits/accountPlan` from the response with the `201` status
- **2026-08-27** `d5f1141f87e3`: 11 warning
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `400`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `401`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `403`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `404`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `409`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `410`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `422`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `429`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `500`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `502`
  - added the new `pacing` enum value to the `error/quotaKind` response property for the response status `503`
- **2026-08-19** `1ad91026000b`: 10 breaking, 5 info
  - the response property `contacts/items/doNotContact` became optional for the status `201`
  - the response property `contacts/items/lastContactedAt` became optional for the status `201`
  - the response property `contacts/items/lastRepliedAt` became optional for the status `201`
  - the response property `contacts/items/outreachStatus` became optional for the status `201`
  - removed the required property `contacts/items/hotScore` from the response with the `201` status
  - removed the required property `contacts/items/leadBrief` from the response with the `201` status
  - removed the required property `contacts/items/lifecycleStage` from the response with the `201` status
  - removed the required property `contacts/items/nextFollowUpAt` from the response with the `201` status
  - removed the required property `contacts/items/qualificationNotes` from the response with the `201` status
  - removed the required property `contacts/items/stageChangedAt` from the response with the `201` status
  - added the optional property `_meta` to the response with the `201` status
  - added the optional property `contacts/items/avatarUrl` to the response with the `201` status
  - added the optional property `contacts/items/humanStatus` to the response with the `201` status
  - added the optional property `contacts/items/lastActivityAt` to the response with the `201` status
  - added the optional property `results/bucketed` to the response with the `201` status
- **2026-08-05** `3caf12036b26`: 1 breaking
  - removed the enum value `approved` of the request property `contacts/items/lifecycleStage`

---

[Operation](https://skmtc.dev/berea/apis/bereach-api/docs/contacts/post.md) · [API](https://skmtc.dev/berea/apis/bereach-api.md) · [Page](https://skmtc.dev/berea/apis/bereach-api/changes/contacts/post)