---
title: "POST /actors/user"
method: POST
path: "/actors/user"
tags: ["Graph", "Principal"]
---

# POST /actors/user

`POST /actors/user`

## Headers

- `X-Authenticated-User-Actor-Id` string, uuid, required

## Request body

- CreateUserActorParams
  - `registrationComplete` boolean, required
  - `shortname` string, nullable

## Response `200`

The schema of the created actor

- CreateUserActorResponse
  - `machineId` string, uuid, required
  - `userId` string, uuid, required

## Other responses

- `500` — Store error occurred

## Changes

- **2025-05-13** `70e46a9499f8` — 2 info
  - api tag `Principal` added
  - api tag `Policies` removed
- **2025-04-24** `ccac01e6aad0` — 2 info
  - api tag `Policies` added
  - api tag `Principal` removed

[Change history](https://skmtc.dev/hashintel/apis/graph/changes/actors/user/post.md)

---

[API](https://skmtc.dev/hashintel/apis/graph.md) · [All operations](https://skmtc.dev/hashintel/apis/graph/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hashintel/graph/revisions/ba95e69ddba8/schema)