---
title: "Changes to Create User Profile"
method: POST
path: "/v1/user_profiles?beta=true"
---

# Changes to Create User Profile

`POST /v1/user_profiles?beta=true`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 67 revisions.

- **2026-08-18** `d3515f9e9eca` — 1 breaking, 2 info
- **2026-08-17** `d2b230555b7f` — 4 breaking, 4 info
- **2026-05-06** `a4186730f56c` — 4 info
- **2026-04-16** `e0696f59ae07` — 1 info

## Changes

- **2026-08-18** `d3515f9e9eca` — 1 breaking, 2 info
  - the response property `relationship` became optional for the status `200`
  - added the new optional request property `access_type`
  - added the optional property `access_type` to the response with the `200` status
- **2026-08-17** `d2b230555b7f` — 4 breaking, 4 info
  - the request property `external_id` became not nullable
  - the request property `name` became not nullable
  - response property `external_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - request property `external_id` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `name` list-of-types was widened by adding types `null` to media type `application/json`
  - the `external_id` request property's minLength was decreased from `1` to `0`
  - the `name` request property's minLength was decreased from `1` to `0`
- **2026-05-06** `a4186730f56c` — 4 info
  - added the new optional request property `name`
  - added the new optional request property `relationship`
  - added the optional property `name` to the response with the `200` status
  - added the required property `relationship` to the response with the `200` status
- **2026-04-16** `e0696f59ae07` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/anthropics/apis/anthropic-api/docs/v1/user_profiles?beta=true/post.md) · [API](https://skmtc.dev/anthropics/apis/anthropic-api.md) · [Page](https://skmtc.dev/anthropics/apis/anthropic-api/changes/v1/user_profiles?beta=true/post)