Create invoice
Create an invoice in the company workspace. Attribute it to an application instance with applicationInstanceId, or leave it unattributed.
curl -X POST "https://api.corma.io/v1/invoices" \
-H "x-corma-api-key: $CORMA_OPEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"supplierName": "string"
}'Authorization
x-corma-api-keystringheaderrequiredColon-separated API key ID and secret:
API_KEY_ID:API_KEY_SECRET
Parameters
x-corma-idempotency-keystringheaderOptional client-generated key. Reusing the same key with an identical request replays the original response instead of enqueueing a duplicate task.
Body
supplierNamestringrequiredapplicationInstanceIdinteger | nullcurrencystring | nulltotalAmountany of | nullA decimal number. Send it as a string, matching
-?\d+(\.\d+)?, to keep full precision.dateany of | nullinvoiceNumberstring | null
Response
OK
idintegerrequiredapplicationInstanceIdinteger | nullrequiredThe application instance this invoice is attributed to, or null when it is not mapped yet.
supplierNamestringrequiredcurrencystring | nullrequiredtotalAmountstring | nullrequiredA decimal number serialized as a string, so no precision is lost.
normalizedTotalAmountstring | nullrequiredA decimal number serialized as a string, so no precision is lost.
datestring<date-time> | nullrequiredinvoiceNumberstring | nullrequiredsourcestring | nullrequiredThe system the invoice came from. Invoices created through this API report
api.createdAtstring<date-time>requiredThe timestamp of when this resource was created. ISO 8601 format.
updatedAtstring<date-time>requiredThe timestamp of the last update to this resource. ISO 8601 format.
{
"id": -9007199254740991,
"applicationInstanceId": -9007199254740991,
"supplierName": "string",
"currency": "string",
"totalAmount": "string",
"normalizedTotalAmount": "string",
"date": "2026-01-15T09:30:00Z",
"invoiceNumber": "string",
"source": "string",
"createdAt": "2026-01-15T09:30:00Z",
"updatedAt": "2026-01-15T09:30:00Z"
}