---
title: "Create an invoice"
description: "Create (or retrieve) an invoice from a Shopify order ID. If the invoice already exists, it is returned. Optionally generates the PDF immediately."
url: https://docs.invoicefalcon.com/api/invoices/create-an-invoice/
api: "API v1 reference"
method: POST
path: "/invoices"
---

# Create an invoice

`POST https://app.invoicefalcon.com/api/v1/external/invoices`

Create (or retrieve) an invoice from a Shopify order ID. If the invoice already exists, it is returned. Optionally generates the PDF immediately.

## Request body

- `order_id` (integer, required): Shopify order or draft order ID.
- `draft` (boolean): Set `true` for draft orders (quotes/pro-formas).
- `generate_pdf` (boolean): Whether to generate the PDF immediately.
- `template_id` (integer): Optional template ID for PDF generation.
- `packing_slip` (boolean): Generate the packing slip instead of the invoice. Inferred automatically when `template_id` points at a packing slip template.

## Returns

The [invoice object](https://docs.invoicefalcon.com/api/invoices/).

Rate limit: this call costs 2 points ([rate limits](https://docs.invoicefalcon.com/docs/rate-limiting/)).

## Examples

### Create the invoice for an order

```sh
curl -X POST "https://app.invoicefalcon.com/api/v1/external/invoices" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": 5873241604411
  }'
```

### Create without generating the PDF

```sh
curl -X POST "https://app.invoicefalcon.com/api/v1/external/invoices" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": 5873241604411,
    "generate_pdf": false
  }'
```

### Create a quote from a draft order

```sh
curl -X POST "https://app.invoicefalcon.com/api/v1/external/invoices" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": 1146789216411,
    "draft": true
  }'
```

### Create the packing slip with a template

```sh
curl -X POST "https://app.invoicefalcon.com/api/v1/external/invoices" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": 5873241604411,
    "template_id": 314,
    "packing_slip": true
  }'
```

## 201

Invoice created.

```json
{
  "invoice": {
    "id": 48213,
    "slug": "k7xq2m9d4r",
    "number": "INV-1042",
    "invoice_type": "invoice",
    "total_price": "100.94",
    "currency": "USD",
    "financial_status": "paid",
    "fulfillment_status": "fulfilled",
    "order_name": "#1042",
    "order_number": 1042,
    "processed_at": "2026-01-15T09:30:00Z",
    "note": "Please leave at the front desk.",
    "created_at": "2026-01-15T09:31:12Z",
    "updated_at": "2026-01-15T09:31:40Z",
    "customer": {
      "id": 9177,
      "email": "jane.doe@example.com",
      "first_name": "Jane",
      "last_name": "Doe"
    },
    "billing_address": {
      "first_name": "Jane",
      "last_name": "Doe",
      "company": "Doe Studio",
      "address1": "12 Example Street",
      "address2": "Suite 4",
      "city": "Springfield",
      "province": "Illinois",
      "country": "United States",
      "zip": "62701",
      "phone": "+1 555 010 0199"
    },
    "shipping_address": {
      "first_name": "Jane",
      "last_name": "Doe",
      "company": null,
      "address1": "12 Example Street",
      "address2": null,
      "city": "Springfield",
      "province": "Illinois",
      "country": "United States",
      "zip": "62701",
      "phone": "+1 555 010 0199"
    },
    "line_items": [
      {
        "title": "Canvas tote bag",
        "variant_title": "Natural / Large",
        "quantity": 2,
        "price": "45.00",
        "sku": "TOTE-NAT-L"
      },
      {
        "title": "Gift wrapping",
        "variant_title": null,
        "quantity": 1,
        "price": "5.00",
        "sku": null
      }
    ],
    "tax_lines": [
      {
        "title": "State tax",
        "rate": 0.0625,
        "price": "5.94"
      }
    ]
  }
}
```

## 401

Missing or invalid API key.

```json
{
  "error": "Invalid API key"
}
```

## 403

The store is not on a paid plan. API access requires a paid Invoice Falcon plan.

```json
{
  "error": "REST API access requires a paid plan"
}
```

## 422

Request could not be processed.

```json
{
  "error": "param is missing or the value is empty: customer",
  "errors": {}
}
```

## 429

Rate limit exceeded. Check `X-RateLimit-Reset` header.

```json
{
  "error": "Rate limit exceeded",
  "retry_after": 30,
  "message": "You have exceeded the rate limit of 40 points per 60 seconds. Read requests cost 1 point(s) and write requests cost 2 point(s). Please retry after 30 second(s)."
}
```

