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

# Changes to Create a contact

`POST /contacts`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 9 revisions.

- **2026-07-28** `8ccfb9a461e2` — 3 breaking, 1 warning, 14 info
- **2026-01-27** `e21feba47bec` — 1 info

## Changes

- **2026-07-28** `8ccfb9a461e2` — 3 breaking, 1 warning, 14 info
  - request body became required
  - request property `age` list-of-types was narrowed by removing types `integer` from media type `application/json`
  - added 'propertyNames' constraint to the request property `customProperties`
  - removed the request property `waProfileName`
  - added the new optional request property `tags`
  - request property `birthdate` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `customProperties/additionalProperties/` list-of-types was widened by adding types `number` to media type `application/json`
  - request property `email` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `firstName` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `gender` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `lastName` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `notes` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `occupation` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `phone` list-of-types was widened by adding types `null` to media type `application/json`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - the response property `id` became required for the status `201`
  - the `id` response's property pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` was added for the status `201`
- **2026-01-27** `e21feba47bec` — 1 info
  - added the new optional request property `customProperties`

---

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