---
title: "POST /stages/user_write/"
method: POST
path: "/stages/user_write/"
tags: ["stages"]
---

# POST /stages/user_write/

`POST /stages/user_write/`

UserWriteStage Viewset

## Request body

- UserWriteStageRequest — UserWriteStage Serializer
  - `name` string, required
  - `user_creation_mode` 'never_create' | 'create_when_required' | 'always_create'
  - `create_users_as_inactive` boolean — When set, newly created users are inactive and cannot login.
  - `create_users_group` string, uuid, nullable — Optionally add newly created users to this group.
  - `user_type` 'internal' | 'external' | 'service_account' | 'internal_service_account'
  - `user_path_template` string

## Response `201`

- UserWriteStage — UserWriteStage Serializer
  - `pk` string, uuid, required
  - `name` string, required
  - `component` string, required — Get object type so that we know how to edit the object
  - `verbose_name` string, required — Return object's verbose_name
  - `verbose_name_plural` string, required — Return object's plural verbose_name
  - `meta_model_name` string, required — Return internal model name
  - `flow_set` FlowSet[], required
    - `pk` string, uuid, required
    - `policybindingmodel_ptr_id` string, uuid, required
    - `name` string, required
    - `slug` string, required — Visible in the URL.
    - `title` string, required — Shown as the Title in Flow pages.
    - `designation` 'authentication' | 'authorization' | 'invalidation' | 'enrollment' | 'unenrollment' | 'recovery' | 'stage_configuration', required
    - `background_url` string, required — Get the URL to the background image
    - `policy_engine_mode` 'all' | 'any'
    - `compatibility_mode` boolean — Enable compatibility mode, increases compatibility with password managers on mobile devices.
    - `export_url` string, required — Get export URL for flow
    - `layout` 'stacked' | 'content_left' | 'content_right' | 'sidebar_left' | 'sidebar_right' | 'sidebar_left_frame_background' | 'sidebar_right_frame_background'
    - `denied_action` 'message_continue' | 'message' | 'continue'
  - `user_creation_mode` 'never_create' | 'create_when_required' | 'always_create'
  - `create_users_as_inactive` boolean — When set, newly created users are inactive and cannot login.
  - `create_users_group` string, uuid, nullable — Optionally add newly created users to this group.
  - `user_type` 'internal' | 'external' | 'service_account' | 'internal_service_account'
  - `user_path_template` string

## Other responses

- `400`
- `403`

---

[API](https://skmtc.dev/goauthentik/apis/authentik.md) · [All operations](https://skmtc.dev/goauthentik/apis/authentik/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goauthentik/authentik/revisions/4e42e86021d7/schema)