Skip to main content
POST
/
api
/
v0
/
invoices
Create a new invoice
curl --request POST \
  --url https://api.devdraft.ai/api/v0/invoices \
  --header 'Content-Type: application/json' \
  --header 'x-client-secret: <api-key>' \
  --data '
{
  "name": "<string>",
  "email": "<string>",
  "customer_id": "<string>",
  "currency": "usdc",
  "items": {},
  "due_date": "2025-05-20",
  "delivery": "EMAIL",
  "payment_link": true,
  "payment_methods": [
    "ACH"
  ],
  "status": "DRAFT",
  "partial_payment": true,
  "address": "<string>",
  "phone_number": "<string>",
  "send_date": "2025-05-20",
  "logo": "<string>",
  "taxId": "<string>"
}
'

Authorizations

​
x-client-secret
string
header
required

Your secret API key. Keep this secure and never expose it in client-side code.

Body

application/json
​
name
string
required

Name of the invoice

​
email
string
required

Email address

​
customer_id
string
required

Customer ID

​
currency
enum<string>
required

Currency for the invoice

Available options:
usdc,
eurc
​
items
object
required
​
due_date
string<date-time>
required

Due date of the invoice

Example:

"2025-05-20"

​
delivery
enum<string>
required

Delivery method

Available options:
EMAIL,
MANUALLY
​
payment_link
boolean
required

Whether to generate a payment link

​
payment_methods
enum<string>[]
required

Array of accepted payment methods

Available options:
ACH,
BANK_TRANSFER,
CREDIT_CARD,
CASH,
MOBILE_MONEY,
CRYPTO
​
status
enum<string>
required

Invoice status

Available options:
DRAFT,
OPEN,
PASTDUE,
PAID,
PARTIALLYPAID
​
partial_payment
boolean
required

Allow partial payments

​
address
string

Address

​
phone_number
string

Phone number

​
send_date
string<date-time>

Send date

Example:

"2025-05-20"

Logo URL

​
taxId
string

Tax ID

Response

The invoice has been successfully created.