---
title: "Create Invoice"
method: POST
path: "/invoices"
tags: ["Invoices"]
---

# Create Invoice

`POST /invoices`

API to create and send an invoice to a customer via email.

## Headers

- `Content-Type` string
- `Authorization` string

## Request body

- object
  - `amount` number, required — The invoice amount to be charged to the customer.
  - `amount_currency` 'AED' | 'USD' | 'EUR' | 'GBP' | 'SAR', required — Currency code for the invoice amount. See [examples](https://help.mamopay.com/en/articles/8225989-supported-currencies) for more details.
  - `email` string, email, required — The customer's email address where the invoice will be sent.
  - `description` string — A description of the invoice. This will appear on the invoice sent to the customer.
  - `customer_type` 'individual' | 'business' — The type of customer receiving the invoice.
  - `first_name` string — The first name of the customer.
  - `last_name` string — The last name of the customer.
  - `phone_number` string — The customer's phone number.
  - `vat_enabled` boolean — Whether VAT should be applied and displayed on the invoice.
  - `additional_heading` string — An optional heading that will appear as additional information on the invoice.
  - `additional_details` string — Optional additional details or notes to include on the invoice.
  - `additional_cc_emails` string[] — A list of additional email addresses to CC when the invoice is sent.
  - `include_external_id` boolean — Whether to display the external ID on the invoice.
  - `external_id` string — An external reference ID of your choice to associate with this invoice.
  - `processing_fee_percentage` number, nullable — A processing fee percentage to be added on top of the invoice amount and charged to the customer.
  - `processing_fee_amount` number, nullable — A fixed processing fee amount to be added on top of the invoice amount and charged to the customer.

## Response `200`

Successful response

- object
  - `id` string — The unique identifier of the created invoice.
  - `status` 'outstanding' | 'paid' | 'cancelled' — The current status of the invoice.
  - `amount` number — The invoice amount.
  - `amount_formatted` string — The invoice amount formatted with the currency code.
  - `amount_currency` string — The currency code of the invoice amount.
  - `description` string — The description provided for the invoice.
  - `customer` object — Details of the customer the invoice was sent to.
    - `name` string — The full name of the customer.
    - `email` string — The email address of the customer.
    - `phone` string — The phone number of the customer.
  - `external_id` string — The external reference ID associated with the invoice.
  - `additional_heading` string — The additional heading displayed on the invoice.
  - `additional_details` string — The additional details displayed on the invoice.
  - `business_name` string, nullable — The business name on the invoice, if applicable.
  - `uae_tax_reference_number` string, nullable — The UAE tax reference number, if applicable.
  - `address` string, nullable — The address associated with the invoice, if applicable.
  - `city` string, nullable — The city associated with the invoice, if applicable.
  - `country` string, nullable — The country associated with the invoice, if applicable.
  - `payment_url` string — The URL where the customer can complete payment for this invoice.
  - `invoice_pdf_url` string, nullable — The URL to download the invoice as a PDF, once generated.
  - `paid_at` string, nullable — The date and time the invoice was paid, if applicable.
  - `created_at` string — The date the invoice was created.

## Other responses

- `403` — Unauthorised
- `422` — Unprocessable entity
- `500` — Unexpected error

---

[API](https://skmtc.net/mamopay/apis/payments.md) · [All operations](https://skmtc.net/mamopay/apis/payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mamopay/payments/revisions/65bb3871a425/schema)