---
search:
  tags:
    - billing
    - POST
seo:
  description: >-
    What does this do? Adds a custom manual… Reference for the POST
    /billing/potential-invoices/{id}/manual-positions endpoint in the Leadtime
    Public API API.
sidebar:
  badge: POST
  label: Add manual position to potential invoice
title: Add manual position to potential invoice
type: openapi-operation
---
**What does this do?**
Adds a custom manual position (line item) to a potential invoice. Manual positions allow you to bill for external costs, flat fees, or other items that aren't automatically created by tickets, products, or subscriptions.

**When to use:**
- To add external costs (e.g., translation services, license costs)
- To add travel expenses or other one-time charges
- To add flat rates with no ticket reference
- To add items that were missing from the original offer

**How it works:**
- Creates a new manual position entry stored in the potential invoice metadata
- The position appears immediately in the invoice preview
- Manual positions are fully integrated into tax and total calculations
- Only custom manual positions (type: manual) can be added, updated, or deleted
- Project manual positions (from project snapshots) are read-only and cannot be modified

**Position requirements:**
- Must provide a unique UUID for the position ID
- Title and price are required
- Price must be a positive number (net amount before tax)

**Invoice ID Format:**
The invoice ID follows the format: {type}::{projectId}::{dateFrom}::{dateTo}
- Example: SingleProject::0e9d033a-ab41-4212-8637-66c4e3b01fe2::2025-10-01::2025-10-31

**Permission requirements:**
Requires Invoices.manage permission and access to the project.

<Operation source="api-reference" id="potentialinvoicescontroller-addmanualposition" />