Skip to main content

Create Invoice πŸ“

In this section, you will learn how to create an invoice using the Billify API step by step.

Step 1: Prepare Your API Keys​

Firstly, you need to prepare your API keys that you will use when sending the invoice creation request. These keys authorize the invoice creation process.

Step 2: Specify Invoice Details​

When sending the invoice creation request, you need to specify the details of the invoice. These details typically include:

  • Customer information: Name, city, postal code, full address, phone number, logo URL, tax number, email address , company number
  • Product/Service details: Product/Service name, purchase price, tax rate, discount rate, quantity, type (product or service)
  • Invoice details: Currency, creation date, due date, invoice type, period, template, status, payment type, notes, terms
  • ÜrΓΌn veya Servislerin hesaplamalarΔ± otomatik yapΔ±lacaktΔ±r

Using this information, you can prepare your invoice creation request.

Step 3: Send a Post Request​

With the prepared invoice details, send a POST request to the https://api.billify.co.uk/invoice endpoint to perform the invoice creation process. Use JSON format in the request body containing your API keys and invoice details.

Example POST request body:

   POST https://api.billify.co.uk/invoice
{
    "apiKey": "YOUR_API_KEY",
    "secretKey": "YOUR_SECRET_KEY",
    "customer_name": "John Doe",
    "customer_city": "New York",
    "customer_postcode": "10001",
    "customer_fulladdress": "123 Main Street",
    "customer_phoneNumber": "123-456-7890",
    "customer_tax": "123456789",
    "customer_mail": "[email protected]",
    "companie_number": "1234567890",
    "proServe": [
        {
            "proServeItem": "Default Product/Service 1",
            "purchasePrice": 100,
            "taxRate": 18,
            "discountRate": 5,
            "quantity": "Piece",
            "piece": "1",
            "type": "Product",
        },
          {
            "proServeItem": "Default Product/Service 2",
            "purchasePrice": 100,
            "taxRate": 18,
            "discountRate": 5,
            "quantity": "Hour",
            "piece": "1",
            "type": "Product",
        }
    ],
    "currency": "GBP",
    "creation_date": "2025-04-22T22:46:54.855+00:00",
    "due_date": "2024-04-22T22:46:54.855+00:00",
    "template": "simplicityInvoice",
    "status": "paid",
    "payment_type": "banktransfer",
    "invoice_notes": "Please make the payment within 30 days.",
    "invoice_terms": "All sales are final. No refunds or returns allowed."
}

Expected Data​

Currencies​

  • "GBP"
  • "JPY"
  • "TRY"
  • "USD"
  • "EUR"

Status​

  • "paid"
  • "due"

Payment Types​

  • "banktransfer"
  • "cash"
  • "cheque"
  • "crypto"
  • "paypal"
  • "creditcard"

Templates​

You can review the following templates on the Invoice Settings page:

  • "classicEleganceInvoice"
  • "creamTouchInvoice"
  • "darkTouchInvoice"
  • "eternalInvoice"
  • "lavenderInvoice"
  • "simplicityInvoice"