---
title: "Changes to Retrieve or create contacts"
method: POST
path: "/contacts"
---

# Changes to Retrieve or create contacts

`POST /contacts`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 11 revisions.

- **2026-10-15** `645bfcebdd56`: 1 info
- **2025-11-20** `d92d55716cc3`: 6 breaking, 1 info

## Changes

- **2026-10-15** `645bfcebdd56`: 1 info
  - added the optional property `contact_list/items/emails` to the response with the `200` status
- **2025-11-20** `d92d55716cc3`: 6 breaking, 1 info
  - the request property `oneOf[#/components/schemas/contact_filter]/alphabetical_order` became not nullable
  - the request property `oneOf[#/components/schemas/contact_filter]/limit_count` became not nullable
  - the request property `oneOf[#/components/schemas/contact_filter]/limit_offset` became not nullable
  - the request property `oneOf[#/components/schemas/contact_filter]/pagination` became not nullable
  - the request property `oneOf[#/components/schemas/contact_filter]/search` became not nullable
  - the `contact_list/items/creation_date` response's property format changed from `date` to `date-time` for status `200`
  - api operation id `postContacts` was added

---

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