---
updatedAt: 2026-05-27T09:39:35.000Z
agentTools:
  projectIndex: https://apis.appdome.com/llms.txt
---

# Create a Company User API

Allows you to create a new user account that belongs to your company.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0.0",
    "title": "Appdome API"
  },
  "servers": [
    {
      "url": "https://fusion.appdome.com/api/v1",
      "description": "Main Appdome API Server"
    },
    {
      "url": "{aws_upload_link}",
      "description": "S3 Upload URL",
      "variables": {
        "aws_upload_link": {
          "default": "",
          "description": "The S3 bucket name from the pre-signed URL. Obtained from 'Get AWS Upload Link' route."
        }
      }
    }
  ],
  "components": {
    "securitySchemes": {
      "apiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization"
      }
    }
  },
  "paths": {
    "/myCompany/users": {
      "post": {
        "tags": [
          "API User Management"
        ],
        "description": "Allows you to create a new user account that belongs to your company.",
        "summary": "Create a Company User API",
        "parameters": [],
        "security": [
          {
            "apiKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "The requested user data",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "created"
                    },
                    "userDetails": {
                      "type": "object",
                      "example": {
                        "id": "064003c0-6472-11eb-a118-fddfdd51",
                        "first_name": "John",
                        "last_name": "Doe",
                        "email": "john@doe.com",
                        "status": "Active",
                        "api_token_enabled": "1",
                        "api_token_permissions": "Write",
                        "country": "US",
                        "api_token": "AUTH_KEY"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "user": {
                    "required": [
                      "first_name",
                      "last_name",
                      "email",
                      "api_token_enabled",
                      "api_token_permissions"
                    ],
                    "properties": {
                      "first_name": {
                        "type": "string",
                        "description": "The user first name",
                        "example": "The user first name"
                      },
                      "last_name": {
                        "type": "string",
                        "description": "The user last name",
                        "example": "The user last name"
                      },
                      "email": {
                        "type": "string",
                        "description": "The user email",
                        "example": "The user email"
                      },
                      "status": {
                        "type": "string",
                        "description": "active or blocked //(default is active)",
                        "example": "active or blocked //(default is active)"
                      },
                      "country": {
                        "type": "string",
                        "description": "iso alpha-2 country code",
                        "example": "iso alpha-2 country code"
                      },
                      "api_token_enabled": {
                        "type": "integer",
                        "enum": [
                          0,
                          1
                        ],
                        "description": "1 - user will have active API access to REST API, 0 - otherwise",
                        "example": 1
                      },
                      "api_token_permissions": {
                        "type": "array",
                        "items": {
                          "type": "string",
                          "enum": [
                            "read",
                            "write",
                            "functional"
                          ]
                        },
                        "description": "Array of API token permissions: read, write, or functional",
                        "example": [
                          "read",
                          "write"
                        ]
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```