---
title: "Create subject"
method: POST
path: "/v1/subjects"
tags: ["Subjects"]
---

# Create subject

`POST /v1/subjects`

Creates a new subject within the authenticated application's tenant scope.

## Request body

- CreateSubjectRequest
  - `externalId` string, required
  - `displayName` string
  - `email` string
  - `metadata` object
  - `imageUrl` string

## Response `201`

Subject created

## Other responses

- `400` — Invalid request payload
- `401` — Missing or invalid bearer token

---

[API](https://skmtc.net/reflexpay/apis/idaas-identity-as-a-service-api.md) · [All operations](https://skmtc.net/reflexpay/apis/idaas-identity-as-a-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reflexpay/idaas-identity-as-a-service-api/revisions/db1f954badfb/schema)