---
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

---

[API](https://skmtc.net/aiven/apis/aiven-api-documentation.md) · [All operations](https://skmtc.net/aiven/apis/aiven-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aiven/aiven-api-documentation/revisions/cbfbf0f96a48/schema)