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

# Changes to Create a contact

`POST /v3/contacts`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 104 revisions.

- **2026-10-16** `6c829543a93e`: 5 breaking, 1 warning, 15 info
- **2026-07-02** `1e113b6a003b`: 1 breaking

## Changes

- **2026-10-16** `6c829543a93e`: 5 breaking, 1 warning, 15 info
  - added `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3SharedMutationRequestBase, subschema #2: SentDmServicesEndpointsCustomerAPIv3ContactsRequestsCreateContactRequest_Properties` to the request body `allOf` list
  - added `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3SharedApiMeta` to the `meta` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3SharedApiMeta` to the `meta` response property `oneOf` list for the response status `400`
  - added `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3SharedApiMeta` to the `meta` response property `oneOf` list for the response status `409`
  - added `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3SharedApiMeta` to the `meta` response property `oneOf` list for the response status `500`
  - removed `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3RequestsMutationRequestBase, subschema #2: SentDmServicesEndpointsCustomerAPIv3RequestsCreateContactRequest_Properties` from the request body `allOf` list
  - the endpoint scheme security `BearerAuth` was added to the API
  - added `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3ContactsResponsesContactResponse` to the `data` response property `allOf` list for the response status `201`
  - added `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3SharedApiError` to the `error` response property `allOf` list for the response status `201`
  - added `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3SharedApiError` to the `error` response property `allOf` list for the response status `400`
  - added `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3SharedApiError` to the `error` response property `allOf` list for the response status `409`
  - added `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3SharedApiError` to the `error` response property `allOf` list for the response status `500`
  - removed `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3ResponsesApiError` from the `error` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3ResponsesApiError` from the `error` response property `allOf` list for the response status `400`
  - removed `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3ResponsesApiError` from the `error` response property `allOf` list for the response status `409`
  - removed `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3ResponsesApiError` from the `error` response property `allOf` list for the response status `500`
  - removed `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3ResponsesContactResponse` from the `data` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3ResponsesApiMeta` from the `meta` response property `oneOf` list for the response status `201`
  - removed `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3ResponsesApiMeta` from the `meta` response property `oneOf` list for the response status `400`
  - removed `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3ResponsesApiMeta` from the `meta` response property `oneOf` list for the response status `409`
  - removed `#/components/schemas/SentDmServicesEndpointsCustomerAPIv3ResponsesApiMeta` from the `meta` response property `oneOf` list for the response status `500`
- **2026-07-02** `1e113b6a003b`: 1 breaking
  - the request property `allOf[subschema #2: SentDmServicesEndpointsCustomerAPIv3RequestsCreateContactRequest_Properties]/phone_number` became required

---

[Operation](https://skmtc.dev/sentdm/apis/sent-dm-api-v3/docs/v3/contacts/post.md) - [API](https://skmtc.dev/sentdm/apis/sent-dm-api-v3.md) - [Page](https://skmtc.dev/sentdm/apis/sent-dm-api-v3/changes/v3/contacts/post)