---
title: "Create Partner"
method: POST
path: "/partners"
tags: ["partners", "Partners"]
---

# Create Partner

`POST /partners`

Create Partner

## Response `201`

The Partners object.

- PartnerEntity — PartnerEntity model
  - `allow_bypassing_2fa_policies` boolean — Allow Partner Admins to change Two-Factor Authentication requirements for Partner Users.
  - `allowed_ips` string — A list of allowed IPs for this Partner. Newline delimited. Partner User IP access is allowed when the IP matches the Partner, User, or Site allowed IP lists.
  - `allow_credential_changes` boolean — Allow Partner Admins to change or reset credentials for users belonging to this Partner.
  - `allow_providing_gpg_keys` boolean — Allow Partner Admins to provide GPG keys.
  - `allow_user_creation` boolean — Allow Partner Admins to create users.
  - `cc_emails_to_responsible_party` boolean — When `true`, emails sent to Partner users are copied to the responsible User or Group.
  - `id` integer — The unique ID of the Partner.
  - `ai_assistant_personality_id` integer — AI Assistant Personality ID assigned to this Partner, if any. Users in the Partner inherit it unless a direct per-user assignment overrides it.
  - `workspace_id` integer — ID of the Workspace associated with this Partner.
  - `name` string — The name of the Partner.
  - `notes` string — Notes about this Partner.
  - `partner_admin_ids` integer[] — Array of User IDs that are Partner Admins for this Partner.
  - `partner_channel_template_id` integer — ID of the Partner Channel Template assigned to this Partner.
  - `partnership_role` 'host' | 'guest' | 'host_and_guest' — This site's role in Partner Site relationships for this Partner. Can be `host`, `guest`, `host_and_guest`, or null.
  - `responsible_group_id` integer — ID of the Group responsible for this Partner.
  - `responsible_user_id` integer — ID of the User responsible for this Partner.
  - `root_folder` string — The root folder path for this Partner.
  - `show_partner_channel_home_page` boolean — Show Partner users a simplified home page built from this Partner's Channels.
  - `tags` string — Comma-separated list of Tags for this Partner. Tags are used for other features, such as UserLifecycleRules, which can target specific tags. Tags must only contain lowercase letters, numbers, and hyphens.
  - `user_ids` integer[] — Array of User IDs that belong to this Partner.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `409` — Conflict
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `423` — Locked
- `429` — Too Many Requests

---

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