---
title: "Changes to Create a new contact"
method: POST
path: "/contacts"
---

# Changes to Create a new contact

`POST /contacts`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 54 revisions.

- **2026-07-26** `d5569b315411` — 1 warning, 1 info
- **2026-07-01** `53ddbce73e46` — 1 info
- **2026-06-30** `2ad05734434b` — 1 breaking, 7 warning, 2 info
- **2026-06-30** `a689a6407360` — 2 warning, 1 info
- **2026-06-27** `30dd625c7515` — 1 warning
- **2026-05-30** `995c56ba9219` — 3 warning, 4 info

## Changes

- **2026-07-26** `d5569b315411` — 1 warning, 1 info
  - added the new `web_session` enum value to the `addresses/items/allOf[#/components/schemas/CommonAddress]/type` response property for the response status `201`
  - added the new `web_session` enum value to the request property `addresses/items/allOf[#/components/schemas/CommonAddress]/type`
- **2026-07-01** `53ddbce73e46` — 1 info
  - added the optional property `notes` to the response with the `201` status
- **2026-06-30** `2ad05734434b` — 1 breaking, 7 warning, 2 info
  - the `addresses/items/` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - removed the request property `emails`
  - removed the request property `phone_numbers`
  - removed the optional property `addresses/items/id` from the response with the `201` status
  - removed the optional property `addresses/items/is_primary` from the response with the `201` status
  - removed the optional property `addresses/items/target` from the response with the `201` status
  - removed the optional property `addresses/items/tm_create` from the response with the `201` status
  - removed the optional property `addresses/items/type` from the response with the `201` status
  - added the new optional request property `addresses`
  - added `#/components/schemas/CommonAddress, subschema #2` to the `addresses/items/` response property `allOf` list for the response status `201`
- **2026-06-30** `a689a6407360` — 2 warning, 1 info
  - removed the optional property `emails` from the response with the `201` status
  - removed the optional property `phone_numbers` from the response with the `201` status
  - added the optional property `addresses` to the response with the `201` status
- **2026-06-27** `30dd625c7515` — 1 warning
  - removed the optional property `phone_numbers/items/number_e164` from the response with the `201` status
- **2026-05-30** `995c56ba9219` — 3 warning, 4 info
  - removed the request property `addresses`
  - removed the optional property `addresses` from the response with the `201` status
  - removed the optional property `notes` from the response with the `201` status
  - added the new optional request property `emails`
  - added the new optional request property `phone_numbers`
  - added the optional property `emails` to the response with the `201` status
  - added the optional property `phone_numbers` to the response with the `201` status

---

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