---
title: "postAPIUsers"
date: "2025-02-21T11:49:46+00:00"
summary: "Learn how to create API users with specific scopes, including payload structure and possible response codes."
image:
type: "page"
url: "/web-governance/postapiusers"
id: "a6e45025-e238-4438-ad9c-1c929ef7b17b"
---

postAPIUsers
------------

This article provides advanced instructions on how to post API users.

### Create Api user

*   Description required: string
*   Scopes:
    *   Array of strings, Items enum
        *   "cms"
        *   "customer"
        *   "customer\_admin"

### Payload

    {
     "description": "string",
     "scopes": [
       "cms"
     ]
    }

### Responses

*   201 Create API  user
    
        {
         "id": "string",
         "description": "string",
         "token": "string",
         "scopes": "string"
        }
    
*   400 Invalid parameters
*       {
         "message": "string",
         "errors": "string"
        }
    
*   403 Not authorized
    
        {
         "message": "string",
         "errors": "string"
        }