---
title: "Create a template"
description: "Create a template"
url: https://docs.invoicefalcon.com/api/templates/create-a-template/
api: "API v1 reference"
method: POST
path: "/templates"
---

# Create a template

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

Create a template

## Request body

- `template` (object, required)
  - `name` (string): e.g. `Wholesale invoice`
  - `template_type` (string): e.g. `invoice` One of: `invoice`, `packing_slip`, `credit_note`.
  - `accent_color` (string): e.g. `#0B7285`
  - `font_family` (string): e.g. `Helvetica`
  - `font_size` (integer): e.g. `11`
  - `date_format` (string): e.g. `%d %b %Y`
  - `invoice_number_prefix` (string): e.g. `WS-`
  - `logo_url` (string): e.g. `https://example.com/logo.png`
  - `logo_width` (integer): e.g. `120`
  - `logo_enabled` (boolean): e.g. `true`
  - `pre_selected_orders` (boolean): e.g. `false`
  - `pre_selected_draft_orders` (boolean)
  - `pre_selected_pos_orders` (boolean)
  - `pre_selected_credit_notes` (boolean)

## Returns

The [template object](https://docs.invoicefalcon.com/api/templates/).

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

## Examples

### Create an invoice template

```sh
curl -X POST "https://app.invoicefalcon.com/api/v1/external/templates" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": {
      "name": "Wholesale invoice",
      "template_type": "invoice",
      "accent_color": "#0B7285",
      "font_family": "Helvetica",
      "font_size": 11,
      "date_format": "%d %b %Y",
      "invoice_number_prefix": "WS-",
      "logo_url": "https://example.com/logo.png",
      "logo_width": 120,
      "logo_enabled": true,
      "pre_selected_orders": false
    }
  }'
```

### Create a packing slip template

```sh
curl -X POST "https://app.invoicefalcon.com/api/v1/external/templates" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": {
      "name": "Warehouse packing slip",
      "template_type": "packing_slip",
      "pre_selected_orders": true
    }
  }'
```

### Create the default credit note template

```sh
curl -X POST "https://app.invoicefalcon.com/api/v1/external/templates" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": {
      "name": "Credit note",
      "template_type": "credit_note",
      "pre_selected_credit_notes": true
    }
  }'
```

## 201

Template created.

```json
{
  "template": {
    "id": 311,
    "name": "Default invoice",
    "template_type": "invoice",
    "design_key": "classic",
    "pre_selected_orders": true,
    "pre_selected_draft_orders": false,
    "pre_selected_pos_orders": false,
    "pre_selected_credit_notes": false,
    "accent_color": "#1F6FEB",
    "font_family": "Helvetica",
    "font_size": 11,
    "date_format": "%d %b %Y",
    "invoice_number_prefix": "INV-",
    "logo_url": "https://example.com/logo.png",
    "logo_width": 120,
    "logo_enabled": true,
    "created_at": "2025-11-03T14:02:00Z",
    "updated_at": "2026-01-10T08:15:00Z"
  }
}
```

## 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)."
}
```

