Create User Profile changedapi/beta/user_profiles/create
Nearest release: v2.1.306, published 2 hours after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+30added
Lines−24removed
From line
19
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits19to this page, all time
The whole hunk
from line 19, old and new numbered
/
from line 19
1919
2020- `"anthropic-beta": optional array of AnthropicBeta`
2121
22 This endpoint is in beta: requests must send `user-profiles-2026-03-24`, `user-profiles-2026-08-18`, or `user-profiles-2026-09-04` in this header.
22 Optional header to specify the beta version(s) you want to use.
2323
2424 - `string`
2525
from line 147
147147
148148- `external_id: optional string or null`
149149
150 Platform's own identifier for this user. Not enforced unique. Maximum 255 characters. Accepted under the `user-profiles-2026-03-24` and `user-profiles-2026-08-18` beta headers; under `user-profiles-2026-09-04` send `external_user_details.reference_id` instead.
150 Platform's own identifier for this user. Not enforced unique. Maximum 255 characters. Legacy field, accepted only under the `user-profiles-2026-03-24` and `user-profiles-2026-08-18` beta headers; without one of them, send `external_user_details.reference_id`.
151151
152152 minLength: 1, maxLength: 255
153153
154154- `external_user_details: optional BetaUserProfileExternalUserDetailsParams`
155155
156 Details about the entity this profile represents, as the platform states them. Every field is optional. Accepted under the `user-profiles-2026-09-04` beta header only.
156 Details about the entity this profile represents, as the platform states them. Every field is optional. Not accepted under the legacy `user-profiles-2026-03-24` and `user-profiles-2026-08-18` beta headers, which take the top-level `external_id` (and, under `user-profiles-2026-08-18`, `external_user_onboarded_at`) instead.
157157
158158 - `account_status: optional "active" or "suspended" or "blocked" or null`
159159
from line 213
213213
214214- `external_user_onboarded_at: optional string`
215215
216 When the entity this profile represents opened its account with the platform, in RFC 3339 format: for an `application` profile, when the end-user signed up; for a `passthrough` profile, when the company became the platform's customer. Must be a complete timestamp no more than 1 minute in the future. Optional. Accepted under the `user-profiles-2026-08-18` beta header; under `user-profiles-2026-09-04` send `external_user_details.onboarded_at` instead.
216 When the entity this profile represents opened its account with the platform, in RFC 3339 format: for an `application` profile, when the end-user signed up; for a `passthrough` profile, when the company became the platform's customer. Must be a complete timestamp no more than 1 minute in the future. Optional. Legacy field, accepted only under the `user-profiles-2026-08-18` beta header; without a legacy header, send `external_user_details.onboarded_at`.
217217
218218 format: date-time
219219
from line 253
253253
254254 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
255255
256 - `name: string or null`
257
258 Real-world name of the entity this profile represents (company or individual). For a company the platform resells Claude access to (`access_type` `passthrough`) this is that company's name. `null` until the platform supplies one.
259
256260 - `trust_grants: map[BetaUserProfileTrustGrant]`
257261
258262 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 273
269273
270274 - `updated_at: string`
271275
272 When this user profile was last modified, in RFC 3339 format. Trust-grant status changes also bump this timestamp.
276 When this user profile was last modified, in RFC 3339 format. It normally also updates shortly after Anthropic gives the profile an approval or withdraws one. Other changes to the statuses that Anthropic reports do not always update it, so read the status itself rather than watching this timestamp.
273277
274278 format: date-time
275279
276280 - `access_type: optional "application" or "passthrough"`
277281
278 How the platform uses the API for this entity: `application` (default) or `passthrough`. Present under the `user-profiles-2026-08-18` and later beta headers.
282 How the platform uses the API for this entity: `application` (default) or `passthrough`. Absent under the legacy `user-profiles-2026-03-24` beta header.
279283
280284 - `"application"`
281285
from line 291
287291
288292 - `external_id: optional string or null`
289293
290 Platform's own identifier for this user. Not enforced unique. Present under the `user-profiles-2026-03-24` and `user-profiles-2026-08-18` beta headers; under `user-profiles-2026-09-04` the value is `external_user_details.reference_id`.
294 Platform's own identifier for this user. Not enforced unique. Legacy field, present only under the `user-profiles-2026-03-24` and `user-profiles-2026-08-18` beta headers; without one of them, the value is `external_user_details.reference_id`.
291295
292296 - `external_user_details: optional BetaUserProfileExternalUserDetails`
293297
294 Details about the entity this profile represents, as the platform states them; not verified by Anthropic. Present under the `user-profiles-2026-09-04` beta header, with every field present and `null` until the platform supplies a value; the earlier beta headers serve `reference_id` as the top-level `external_id`, and `user-profiles-2026-08-18` serves `onboarded_at` as `external_user_onboarded_at`.
298 Details about the entity this profile represents, as the platform states them; not verified by Anthropic. Every field is present, `null` until the platform supplies a value. Absent under the legacy `user-profiles-2026-03-24` and `user-profiles-2026-08-18` beta headers, which serve `reference_id` as the top-level `external_id` and, under `user-profiles-2026-08-18`, `onboarded_at` as `external_user_onboarded_at`.
295299
296300 - `account_status: "active" or "suspended" or "blocked" or null`
297301
from line 349
345349
346350 - `external_user_onboarded_at: optional string or null`
347351
348 When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one. Present under the `user-profiles-2026-08-18` beta header; under `user-profiles-2026-09-04` the value is `external_user_details.onboarded_at`.
352 When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one. Legacy field, present only under the `user-profiles-2026-08-18` beta header; without a legacy header, the value is `external_user_details.onboarded_at`.
349353
350354 format: date-time
351355
352 - `name: optional string or null`
353
354 Real-world name of the entity this profile represents (company or individual). For a company the platform resells Claude access to (`access_type` `passthrough`) this is that company's name.
355
356356## Example
357357
358358```bash
from line 362
362362 -H 'anthropic-beta: user-profiles-2026-08-18' \
363363 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
364364 -d '{
365 "external_id": "user_12345",
366 "external_user_onboarded_at": "2024-11-02T08:15:00Z",
367 "metadata": {}
365 "external_user_details": {
366 "account_status": "active",
367 "country": "US",
368 "entity_type": "business",
369 "onboarded_at": "2024-11-02T08:15:00Z",
370 "reference_id": "user_12345"
371 },
372 "metadata": {},
373 "name": "Example User"
368374 }'
369375```
370376
from line 381
375381 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
376382 "created_at": "2026-03-15T10:00:00Z",
377383 "metadata": {},
384 "name": "Example User",
378385 "trust_grants": {
379386 "cyber": {
380387 "status": "active"
from line 393
386393 "external_id": "user_12345",
387394 "external_user_details": {
388395 "account_status": "active",
389 "country": "country",
390 "email_hash": "email_hash",
391 "entity_type": "individual",
392 "name_hash": "name_hash",
393 "onboarded_at": "2019-12-27T18:11:19.117Z",
394 "reference_id": "reference_id"
396 "country": "US",
397 "email_hash": null,
398 "entity_type": "business",
399 "name_hash": null,
400 "onboarded_at": "2024-11-02T08:15:00Z",
401 "reference_id": "user_12345"
395402 },
396 "external_user_onboarded_at": "2024-11-02T08:15:00Z",
397 "name": "Example User"
403 "external_user_onboarded_at": "2024-11-02T08:15:00Z"
398404}
399405```
400406
No line in this hunk matches that.