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

# Changes to Create a contact

`POST /contacts`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 4 revisions.

- **2026-11-05** `cf0885e90d5a`: 8 warning
- **2026-11-03** `fe500ab59b3b`: 4 breaking, 20 warning, 7 info

## Changes

- **2026-11-05** `cf0885e90d5a`: 8 warning
  - added the new `forbidden` enum value to the `error/code` response property for the response status `401`
  - added the new `forbidden` enum value to the `error/code` response property for the response status `403`
  - added the new `forbidden` enum value to the `error/code` response property for the response status `422`
  - added the new `forbidden` enum value to the `error/code` response property for the response status `429`
  - added the new `segment_builder_required` enum value to the `error/code` response property for the response status `401`
  - added the new `segment_builder_required` enum value to the `error/code` response property for the response status `403`
  - added the new `segment_builder_required` enum value to the `error/code` response property for the response status `422`
  - added the new `segment_builder_required` enum value to the `error/code` response property for the response status `429`
- **2026-11-03** `fe500ab59b3b`: 4 breaking, 20 warning, 7 info
  - the response property `data/email` became nullable for the status `201`
  - the response property `data/first_name` became nullable for the status `201`
  - the response property `data/last_name` became nullable for the status `201`
  - the response property `data/phone_number` became nullable for the status `201`
  - added the new `api_access_required` enum value to the `error/code` response property for the response status `401`
  - added the new `api_access_required` enum value to the `error/code` response property for the response status `403`
  - added the new `api_access_required` enum value to the `error/code` response property for the response status `422`
  - added the new `api_access_required` enum value to the `error/code` response property for the response status `429`
  - added the new `contacts_not_ready` enum value to the `error/code` response property for the response status `401`
  - added the new `contacts_not_ready` enum value to the `error/code` response property for the response status `403`
  - added the new `contacts_not_ready` enum value to the `error/code` response property for the response status `422`
  - added the new `contacts_not_ready` enum value to the `error/code` response property for the response status `429`
  - added the new `no_connected_store` enum value to the `error/code` response property for the response status `401`
  - added the new `no_connected_store` enum value to the `error/code` response property for the response status `403`
  - added the new `no_connected_store` enum value to the `error/code` response property for the response status `422`
  - added the new `no_connected_store` enum value to the `error/code` response property for the response status `429`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `401`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `403`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `422`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `429`
  - added the new `store_unavailable` enum value to the `error/code` response property for the response status `401`
  - added the new `store_unavailable` enum value to the `error/code` response property for the response status `403`
  - added the new `store_unavailable` enum value to the `error/code` response property for the response status `422`
  - added the new `store_unavailable` enum value to the `error/code` response property for the response status `429`
  - added the new optional `header` request parameter `Privy-Account-Id`
  - added the optional property `data/email_consent_at` to the response with the `201` status
  - added the optional property `data/import_ids` to the response with the `201` status
  - added the optional property `data/imported` to the response with the `201` status
  - added the optional property `data/sms_consent_at` to the response with the `201` status
  - added the optional property `data/source` to the response with the `201` status
  - added the optional property `data/source_type` to the response with the `201` status

---

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