---
title: "Create a new Provider Administrator"
method: POST
path: "/api/v2/providers/{provider_id}/administrators"
tags: ["Providers", "Managed Service Provider"]
---

# Create a new Provider Administrator

`POST /api/v2/providers/{provider_id}/administrators`

## Request

- Base URL: `https://console.jumpcloud.com`
- URL: `https://console.jumpcloud.com/api/v2/providers/{provider_id}/administrators`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/docs/api/v2/providers/:provider_id/administrators/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows you to create a provider administrator. You must be associated with the provider to use this route. You must provide either `role` or `roleName`.

## Request body

- ProviderAdminReq
  - `apiKeyAllowed` boolean
  - `apiKeyHash` object
    - `createdAt` string, date-time
    - `expireAt` string, date-time
    - `prefix` string
  - `bindNoOrgs` boolean
  - `email` string, required
  - `enableMultiFactor` boolean
  - `firstname` string
  - `lastname` string
  - `role` string
  - `roleName` string
  - `roles` string[]: Array of role ObjectIds for multi-role assignment (optional, requires feature flag)
  - `administratorOrganizations` string[]: Array of organization ObjectIds for multi-org admin assignment (optional, requires multi-org admin workflow feature flag)

## Response `200`

- Administrator
  - `apiKeyAllowed` boolean
  - `apiKeyHash` object
    - `createdAt` string, date-time
    - `expireAt` string, date-time
    - `prefix` string
  - `apiKeySet` boolean
  - `email` string
  - `enableMultiFactor` boolean
  - `firstname` string
  - `id` string
  - `lastname` string
  - `registered` boolean
  - `role` string
  - `roleName` string
  - `roles` string[]
  - `roleNames` string[]
  - `suspended` boolean
  - `organizationAccessTotal` number

## Other responses

- `401`

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/revisions/f396d9271b46?raw)