---
title: "🔒 Create revenue account mapping"
method: POST
path: "/api/v1/revenueAccountMapping/group"
tags: ["Revenue Account Mapping"]
---

# 🔒 Create revenue account mapping

`POST /api/v1/revenueAccountMapping/group`

## Request

- Base URL: `https://xentral.xentral.biz`
- URL: `https://xentral.xentral.biz/api/v1/revenueAccountMapping/group`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/xentral/apis/xentral-api/docs/api/v1/revenueAccountMapping/group/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

Create revenue account mapping

## Request body

- object
  - `name` string, required
  - `accountId` string, required
  - `deliveryCountryCode` string[], required
  - `project` object[]
    - `id` string, required: Entity ID
    - `name` string, required: Entity display name
  - `product` object[]
    - `id` string, required: Entity ID
    - `name` string, required: Entity display name
  - `productCategory` object[]
    - `id` string, required: Entity ID
    - `name` string, required: Entity display name
  - `taxType` object[]
    - `id` string, required: Entity ID
    - `name` string, required: Entity display name
  - `shop` object[]
    - `id` string, required: Entity ID
    - `name` string, required: Entity display name
  - `isActive` boolean

## Response `201`

Created

- object: Grouped revenue account mapping entry (posting rule exception). Aggregates the OR-rows that share a group id.
  - `groupId` string: Group ID
  - `name` string: Name of the mapping
  - `account` object: Booking account
  - `deliveryCountryCode` string[]: Delivery country codes
  - `taxType` object[]
    - `id` string, required: Entity ID
    - `name` string, required: Entity display name
  - `project` object[]
    - `id` string, required: Entity ID
    - `name` string, required: Entity display name
  - `product` object[]
    - `id` string, required: Entity ID
    - `name` string, required: Entity display name
  - `productCategory` object[]
    - `id` string, required: Entity ID
    - `name` string, required: Entity display name
  - `shop` object[]
    - `id` string, required: Entity ID
    - `name` string, required: Entity display name
  - `isActive` boolean: Is active
  - `createdAt` string, date-time: Created at timestamp
  - `updatedAt` string, date-time: Updated at timestamp

## Other responses

- `400`: XGL Problem
- `401`: Unable to authenticate the client
- `403`: Unable to authorize the client
- `409`: IETF RFC 9457 Problem API compliant response
- `415`: Resource representation send in the request is not supported.
- `429`: Too many API calls made.
- `500`: XGL Problem

## Changes

- **2026-11-03** `ebe5ba2a4ed8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/xentral/apis/xentral-api/changes/api/v1/revenueAccountMapping/group/post.md)

---

[API](https://skmtc.dev/xentral/apis/xentral-api.md) - [All operations](https://skmtc.dev/xentral/apis/xentral-api/llms.txt) - [OpenAPI document](https://skmtc.dev/xentral/apis/xentral-api/revisions/ebe5ba2a4ed8?raw)