---
title: "Create an organization billing group"
method: POST
path: "/organization/{organization_id}/billing-groups"
tags: ["OrganizationBillingGroup"]
---

# Create an organization billing group

`POST /organization/{organization_id}/billing-groups`

## Path parameters

- `organization_id` string, required

## Request body

- OrganizationBillingGroupCreateRequestBody — OrganizationBillingGroupCreateRequestBody
  - `billing_address_id` string, required — Billing address ID
  - `billing_contact_emails` object[], required — List of billing contact emails
    - `email` string, required — Email
  - `billing_emails` object[], required — List of billing contact emails
    - `email` string, required — Email
  - `billing_group_name` string, required — Billing Group Name
  - `custom_invoice_text` string — Extra billing text
  - `payment_method` object, required — Payment method
    - `payment_method_id` string, required — Payment method ID
    - `payment_method_type` 'aws_subscription' | 'azure_subscription' | 'bank_transfer' | 'credit_card' | 'gcp_subscription' | 'custom', required — An enumeration.
  - `shipping_address_id` string, required — Shipping address ID
  - `vat_id` string — VAT ID

## Response `200`

Response

- OrganizationBillingGroupCreateResponse — OrganizationBillingGroupCreateResponse
  - `billing_address_id` string, required — Billing address ID
  - `billing_contact_emails` object[], required — List of billing contact emails
    - `email` string, required — Email
  - `billing_emails` object[], required — List of billing contact emails
    - `email` string, required — Email
  - `billing_group_id` string, required — Billing group ID
  - `billing_group_name` string, required — Billing Group Name
  - `create_time` string, required — The date when this billing group was created
  - `custom_invoice_text` string — Extra billing text
  - `organization_id` string, required — Organization ID
  - `payment_method` object — Payment method
    - `payment_method_id` string, required — Payment method ID
    - `payment_method_type` 'aws_subscription' | 'azure_subscription' | 'bank_transfer' | 'credit_card' | 'gcp_subscription' | 'custom', required — An enumeration.
  - `shipping_address_id` string, required — Shipping address ID
  - `vat_id` string — VAT ID

## Other responses

- `400` — Invalid request parameters
- `404` — Resource not found

## Changes

- **2026-09-21** `7f378868f351` — 2 breaking, 2 info
  - removed the enum value `aws_subscription_v1` of the request property `payment_method/payment_method_type`
  - removed the enum value `gcp_subscription_v1` of the request property `payment_method/payment_method_type`
  - removed the `aws_subscription_v1` enum value from the `payment_method/payment_method_type` response property for the response status `200`
  - removed the `gcp_subscription_v1` enum value from the `payment_method/payment_method_type` response property for the response status `200`
- **2026-09-09** `c3d7cd304ef2` — 2 warning, 2 info
  - added the new `aws_subscription_v1` enum value to the `payment_method/payment_method_type` response property for the response status `200`
  - added the new `gcp_subscription_v1` enum value to the `payment_method/payment_method_type` response property for the response status `200`
  - added the new `aws_subscription_v1` enum value to the request property `payment_method/payment_method_type`
  - added the new `gcp_subscription_v1` enum value to the request property `payment_method/payment_method_type`

[Change history](https://skmtc.dev/aiven/apis/aiven-api-documentation/changes/organization/:organization_id/billing-groups/post.md)

---

[API](https://skmtc.dev/aiven/apis/aiven-api-documentation.md) · [All operations](https://skmtc.dev/aiven/apis/aiven-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/aiven/apis/aiven-api-documentation/revisions/90f50802482d?raw)