---
title: "Create Usage"
method: POST
path: "/api/admin/usage"
tags: ["admin-usage"]
---

# Create Usage

`POST /api/admin/usage`

## Request

- Base URL: `https://api.outcallerai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outcallerai.com/api/admin/usage`
- Auth: none declared

## Request body

- CreateUsageRequest
  - `workspace_id` string, required
  - `period_start` string, nullable
  - `period_end` string, nullable
  - `total_call_usage` integer
  - `total_whatsapp_usage` integer
  - `total_call_cost` number
  - `total_whatsapp_cost` number
  - `total_elevenlabs_cost` number
  - `total_elevenlabs_usage` integer
  - `total_echo_input_tokens` integer
  - `total_echo_output_tokens` integer
  - `total_echo_cost` number
  - `total_cost` number

## Response `201`

Successful Response

- CreateUsageResponse
  - `id` string, required
  - `workspace_id` string, required
  - `workspace_name` string, required
  - `total_call_usage` integer, required
  - `total_cost` number, required
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

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