Promote a user to publisher account admin

Operation

POST /publishers/{publisher_id}/account_admins

Marks an existing user on the publisher as one of its account administrators. Limited to HiEnergy admins or the publisher's existing account admins. MCP service accounts cannot be promoted.

Parameters

Request Body

{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "user_id": {
            "type": "integer"
          }
        },
        "required": [
          "user_id"
        ]
      },
      "examples": {
        "promote_user": {
          "summary": "Promote user 42",
          "value": {
            "user_id": 42
          }
        }
      }
    }
  }
}

Responses

{
  "description": "User is now an account admin",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PublisherAccountAdmin"
      }
    }
  }
}

{
  "$ref": "#/components/responses/Unauthorized"
}

{
  "$ref": "#/components/responses/Forbidden"
}

{
  "$ref": "#/components/responses/NotFound"
}

{
  "description": "Validation failed (e.g. user not on publisher, MCP service account, etc.)",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}

API Playground

The in-page tester only supports GET. For POST, use the sample curl below or the dedicated resource docs (e.g. Contacts, Link Builder). Sign in to enable live testing with your API key.

Example request (replace YOUR_API_KEY or sign in above):

curl -X POST "https://app.hienergy.ai/api/v1/publishers/1/account_admins" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Accept: application/json"
  -H "Content-Type: application/json" \
  -d '{}'