---
title: "Create an Actor"
method: POST
path: "/actors"
tags: ["Actors"]
---

# Create an Actor

`POST /actors`

## Request body

- ActorCreateRequest — POST body for creating an Actor
  - `actor` object, required
    - `allow_email_otp_sign_in` boolean — Allow Email OTP Sign In
    - `email` string, nullable — Actor Email. Optional for service accounts.
    - `name` string, required — Actor Name
    - `type` 'account_user' | 'account_admin_user' | 'service_account', required — Actor Type

## Response `201`

ActorResponse

- ActorResponse — Response schema for single Actor
  - `data` Actor — Actor
    - `allow_email_otp_sign_in` boolean — Allow Email OTP Sign In
    - `created_by_directory_id` string, uuid, nullable — Directory ID that created this actor
    - `email` string, nullable, required — Actor Email
    - `id` string, uuid — Actor ID
    - `inserted_at` string, date-time — When the actor was created
    - `is_disabled` boolean — Whether the actor is disabled
    - `last_seen_at` string, date-time, nullable — Last time the actor was seen
    - `name` string, required — Actor Name
    - `type` string, required — Actor Type
    - `updated_at` string, date-time — When the actor was last updated

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Content
- `429` — Too Many Requests

---

[API](https://skmtc.dev/firezone/apis/firezone-api.md) · [All operations](https://skmtc.dev/firezone/apis/firezone-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/firezone/firezone-api/revisions/110de2cb2283/schema)