---
title: "Create Programmatic User"
method: POST
path: "/setup/user/programmatic"
tags: ["Organizations"]
---

# Create Programmatic User

`POST /setup/user/programmatic`

This API creates a new programmatic user (not a human user). Use this API to provide privileges to an application that needs to interface with  Spot. Spot returns a token that the programmatic user can use to perform actions with. requires `accounts` or `policies`.

## Request body

- object
  - `description` string — Brief description of the user.
  - `name` string, required — Name of the programmatic user. Note: names cannot include these characters: + = @
  - `accounts` object[] — All the accounts the programmatic user will have access to. If used - Cannot be empty.
    - `id` string — Account ID the programmatic user will have access to.
    - `role` 'viewer' | 'editor' — Role to be associated with the programmatic user for this account.
  - `policies` object[] — All the policies the programmatic user will have access to. If used - Cannot be empty.
    - `policyId` string — Policy ID the programmatic user will have access to.
    - `accountIds` string[] — The accounts to enforce the policy for the user. Use "*" if you want to include all current accounts and any accounts created in the future.

## Response `200`

Create Programmatic User Response

- object
  - `response` object — Response package that includes, status, type and any relevant data.
    - `status` object
      - `code` integer — HTTP status code assigned to this response
      - `message` string — HTTP status message for the respective status code
    - `kind` string — The data type of each item in the response
    - `items` object[] — Array of data objects
      - `token` string — Token
      - `name` string — Name
      - `id` string — ID
    - `count` integer — Size of the data object array

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/spot/apis/spot-by-flexera-api.md) · [All operations](https://skmtc.net/spot/apis/spot-by-flexera-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spot/spot-by-flexera-api/versions/2e5445f30576/schema)