---
url: /orchestration/reference/operations/CreateFund.md
description: 'POST /v2/consumer/funds — The id is the only way to reach the fund, so keep it secret, in your app''s state'
---

> Documentation index: https://developer.civitai.com/llms.txt — every page on this site has a markdown version at its URL + `.md`.

# The id is the only way to reach the fund, so keep it secret, in your app's state

`POST https://orchestration.civitai.com/v2/consumer/funds`

Operation `CreateFund` · Funds · Civitai Orchestration API, generated from the published OpenAPI spec ([v2-consumers.json](https://developer.civitai.com/openapi/v2-consumers.json)); the interactive HTML page is this URL without `.md`.

## Authentication

Send `Authorization: Bearer <token>` (the spec's `ApiKey` scheme); this operation documents `401 Unauthorized` for a missing or invalid token. See [Authentication](https://developer.civitai.com/orchestration/guide/authentication.md).

## Parameters

None.

## Request body

Optional. Content types: `application/json`, `text/json`, `application/*+json`.

Schema `FundTemplate`.

| Field | Type | Required | Description |
|---|---|---|---|
| `ttl` | string (date-span), nullable | no | How long until the fund is deleted on its own. Defaults to 24 hours, at most 7 days. |
| `allowMatureContent` | boolean | no | Whether workflows billed to this fund may return mature content. Deposits are then limited to Yellow, and Blue from members. (default `false`) |
| `description` | string, nullable | no | Shown on each deposit in the depositor's Buzz history, e.g. "Game pot deposit". |

## Responses

### 201 Created

Content type: `application/json`.

Schema `FundResponse`.

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | yes |  |
| `allowMatureContent` | boolean | yes |  |
| `description` | string, nullable | no |  |
| `createdAt` | string (date-time) | yes |  |
| `expiresAt` | string (date-time) | yes |  |
| `balance` | integer (int32) | yes |  |
| `balances` | map of integer (int32) | yes | Balance per currency (`yellow`, `blue`, `green`, `fakeRed`). |

### 400 Bad Request

Content type: `application/json`.

Schema `ProblemDetails`.

| Field | Type | Required | Description |
|---|---|---|---|
| `type` | string, nullable | no |  |
| `title` | string, nullable | no |  |
| `status` | integer (int32), nullable | no |  |
| `detail` | string, nullable | no |  |
| `instance` | string, nullable | no |  |

### 401 Unauthorized

Content type: `application/json`.

Schema `ProblemDetails` — fields as listed above.

### 403 Forbidden

Content type: `application/json`.

Type: string.