---
updatedAt: 2026-09-28T09:51:44.000Z
agentTools:
  projectIndex: https://docs.umbrellacost.io/llms.txt
---

# Create Mapping Group

Create a mapping group in a viewpoint.

Note: This is only the creation, **without** associating it with a business mapping.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Cost & Usage",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.umbrellacost.io"
    }
  ],
  "x-readme": {
    "explorer-enabled": false
  },
  "paths": {
    "/api/v2/business-mapping/viewpoints/{viewpoint-id}/mapping-groups": {
      "post": {
        "responses": {
          "200": {
            "description": ""
          }
        },
        "parameters": [
          {
            "in": "header",
            "name": "apikey",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "in": "header",
            "name": "Authorization",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "in": "path",
            "name": "viewpoint-id",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "summary": "Create Mapping Group",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "color": {
                    "type": "string",
                    "description": "hex color code."
                  }
                },
                "required": [
                  "name"
                ]
              }
            }
          }
        },
        "operationId": "post_api-v2-business-mapping-viewpoints-viewpoint-id-mapping-groups"
      }
    }
  }
}
```