---
title: "POST /owners"
method: POST
path: "/owners"
tags: ["owners"]
---

# POST /owners

`POST /owners`

Creates an owner.

## Request body

- CreateOwnerInfo — # CreateOwnerInfo Object ### Description The `CreateOwnerInfo` object is used to store creation info for an owner. ### Usage Example Use in the `POST Owners` endpoint.
  - `name` string, required — The name of the owner.
  - `description` string — A description of the owner.
  - `access_request_escalation_period` integer — The amount of time (in minutes) before the next reviewer is notified. Use 0 to remove escalation policy.
  - `user_ids` string[], required — Users to add to the created owner. If setting a source_group_id this list must be empty.
  - `reviewer_message_channel_id` string — The message channel id for the reviewer channel.
  - `source_group_id` string, uuid — Sync this owner's user list with a source group.

## Response `200`

The owner just created.

- Owner — # Owner Object ### Description The `Owner` object is used to represent an owner.
  - `owner_id` string, uuid, required — The ID of the owner.
  - `name` string — The name of the owner.
  - `description` string — A description of the owner.
  - `access_request_escalation_period` integer — The amount of time (in minutes) before the next reviewer is notified. Use 0 to remove escalation policy.
  - `reviewer_message_channel_id` string, uuid, nullable
  - `source_group_id` string, uuid, nullable

---

[API](https://skmtc.net/opal/apis/opal-api.md) · [All operations](https://skmtc.net/opal/apis/opal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opal/opal-api/revisions/13b58df96d40/schema)