---
title: "SetupEnterpriseBilling"
method: POST
path: "/gitpod.v1.BillingService/SetupEnterpriseBilling"
tags: ["gitpod.v1.BillingService"]
---

# SetupEnterpriseBilling

`POST /gitpod.v1.BillingService/SetupEnterpriseBilling`

Sets up enterprise billing for an organization.

 Creates a Stripe customer, subscribes to the enterprise pricing plan,
 and updates the billing realm. Idempotent — safe to retry on failure.

 Requires the 'change_billing_realm' account permission.

 ### Examples

 - Setup enterprise billing (production):

   ```yaml
   organizationId: "b0e12f6c-4c67-429d-a4a6-d9838b5da047"
   email: "billing@example.com"
   ```

 - Setup enterprise billing (sandbox):

   ```yaml
   organizationId: "b0e12f6c-4c67-429d-a4a6-d9838b5da047"
   sandbox: true
   ```

## Request body

- GitpodV1SetupEnterpriseBillingRequest
  - `email` string, email, nullable — email is the email address for the Stripe customer (optional)
  - `organizationId` string, uuid, required — organization_id is the ID of the organization to set up enterprise billing for
  - `sandbox` boolean — sandbox selects the sandbox billing environment. If false or unset, production is used.
  - `setEnterpriseTier` boolean — set_enterprise_tier also sets the organization tier to Enterprise. If false or unset, the organization must already be on Enterprise tier.

## Response `200`

Success

- GitpodV1SetupEnterpriseBillingResponse
  - `stripeCustomerId` string, required — stripe_customer_id is the created or existing Stripe customer ID

## Other responses

- `default` — Error

## Changes

- **2026-02-11** `b97dcde84128` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gitpod-io/apis/gitpod-v1/changes/gitpod.v1.BillingService/SetupEnterpriseBilling/post.md)

---

[API](https://skmtc.dev/gitpod-io/apis/gitpod-v1.md) · [All operations](https://skmtc.dev/gitpod-io/apis/gitpod-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gitpod-io/gitpod-v1/revisions/b97dcde84128/schema)