Skip to main content
POST
Create an invoice

Authorizations

Authorization
string
header
required

An access token (at_test_… or at_live_…) from POST https://idp.talescria.com/oauth/token.

Headers

Idempotency-Key
string
required

A unique key for this operation. Send the same key when you retry it. Kept for 24 hours.

Required string length: 8 - 255
Pattern: ^[A-Za-z0-9_\-:.]+$

Body

application/json
accountId
string
required
customerId
string
required
dueAt
integer
required

Epoch ms.

lines
object[]
required
Required array length: 1 - 100 elements
tax
object
memo
string
Maximum string length: 2000
issuedAt
integer

The invoice date, epoch ms. Default now.

poNumber
string
Maximum string length: 64
servicePeriod
object
internalNote
string

Your own; never on the document or shown to the payer.

Maximum string length: 2000
notify
boolean
default:true

false issues it without emailing.

cc
string<email>[]

Who to copy, from the customer's own extra addresses. Absent: all of them. Anyone else is refused.

Maximum array length: 5

Response

Issued.

invoice
object
emailed
boolean