Skip to main content

Create a new invoice

POST 
/contracts/:contractId/invoices

Creates a new invoice with the provided details. This endpoint provides a signed URL for uploading a PDF invoice.

tip

Recommended guide If you are unsure which parameters to include when creating a gas or electricity invoice, refer to the complete documentation.

Steps and considerations​

  1. POST invoice metadata to obtain the upload URL (fileUrl field).
  2. PUT the PDF file to the returned URL (valid for 15 minutes).

Important: After creating the invoice, the PDF must be uploaded to the fileUrl returned in the response. If the PDF is not uploaded, the invoice will not be processed and will not be available to the customer.

Request​

Responses​

Invoice created successfully