Allowed Scopes: experimental:intake:write

Create a new incoming invoice or credit note for a company's invoice inbox. This is step 3 of 3 in creating an intake from a document.

documentId is required and comes from an earlier upload: create one with Create an intake file upload, send the file to the presigned URL, then poll Get an intake file upload status until it reports ready and returns the documentId.

Idempotent retries. Send an optional Idempotency-Key header, any string of 1 to 255 characters such as your own system or ERP reference, to make a retry safe. Repeating a request with the same key for the same company returns 201 with the original intake and alreadyExisted: true, and creates nothing. The key is scoped to the company, so the same key sent by two companies creates two intakes, and it never expires. Once an intake is deleted, its key stays spent: retrying with it returns 409 rather than recreating the intake.

Note that the request body is ignored when a key is reused: if you send the same key with a different invoice, you receive the first intake back and the new body is discarded. Use a new key for each genuinely different invoice.