---
title: "Add moderator or admin"
method: POST
path: "/v2/organizations/{org_id}/admins"
---

# Add moderator or admin

`POST /v2/organizations/{org_id}/admins`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/organizations/{org_id}/admins`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/organizations/:org_id/admins/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to add an admin or moderator to an organization.

## Request body

- object
  - `type` string, required: User's type of access in the organization. Possible values: `moderator`, `admin`.
  - `email` string, required: Email of the user invited.

## Response `200`

Successful response. Returns the ID of the invitation to become an admin or moderator. A user who isn't registered in SignNow is also invited, with the `pending` status.

- object
  - `data` object, required: User added as an admin or moderator.
    - `id` string, required: ID of the user.
    - `type` string, required: Type of the user: `admin` or `moderator`.
    - `email` string, required: Email address of the user.
    - `status` string, required: Status of the invite. `pending` until the user accepts it.

## Other responses

- `400`: * Wrong, expired, or missing token. * `email` is missing. * `type` is missing. * `type` isn't `admin` or `moderator`. * `email` isn't a valid email address. * The user is already an admin or moderator of the organization.
- `403`: * The user isn't an admin or moderator of the organization. * A moderator tries to add an admin. * The user doesn't have an active trial, Professional, or Enterprise subscription.
- `404`: The organization doesn't exist or isn't active.

---

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