---
title: "Activate System User"
method: POST
path: "/systemusers/{id}/state/activate"
tags: ["Systemusers"]
---

# Activate System User

`POST /systemusers/{id}/state/activate`

## Request

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

This endpoint changes the state of a STAGED user to ACTIVATED.
#### Email Flag
Use the "email" flag to determine whether or not to send a Welcome or
Activation email to the newly activated user. Sending an empty body
without the `email` flag, will send an email with default behavior
(see the "Behavior" section below)
```
{}
```
Sending `email=true` flag will send an email with default behavior (see `Behavior` below)
```
{ "email": true }
```
Populated email will override the default behavior and send to the specified email value
```
{ "email": "example@example.com" }
```
Sending `email=false` will suppress sending the email
```
{ "email": false }
```
#### Behavior
Users with a password will be sent a Welcome email to:
  - The address specified in `email` flag in the request
  - If no `email` flag, the user's primary email address (default behavior)
Users without a password will be sent an Activation email to:
  - The address specified in `email` flag in the request
  - If no `email` flag, the user's alternate email address (default behavior)
  - If no alternate email address, the user's primary email address (default behavior)

#### Sample Request
```
curl -X POST https://console.jumpcloud.com/api/systemusers/{id}/state/activate \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: <api-key>' \
  -d '{ "email": "alternate-activation-email@email.com" }'

```

## Path parameters

- `id` string, required

## Request body

- object
  - `email` object

## Response `200`

OK

- string

## Other responses

- `400`: Bad Request
- `401`: Unauthenticated
- `403`: Unauthorized
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

---

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