Docs for selling gifts inside your app.
The sandbox covers gift pages, AI proofs, quotes, orders and webhooks. Production is enabled from Kadolia admin after app approval.
Sandbox quickstart
curl https://api.kadolia.com/v1/gift-pages \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
"recipient": "Mia",
"occasion": "birthday",
"message": "Made this for your day.",
"product": "folded_card"
}'Core endpoints
POST /v1/gift-pagesCreate the recipient page with photo, message, occasion and Gift Pass.
POST /v1/rendersGenerate visible proof, AI assets and print-ready files when applicable.
POST /v1/quotesQuote products, shipping, SLA, estimated taxes, provider and margin.
POST /v1/ordersSubmit a live order after app approval, payment and content validation.
POST /v1/webhooks/testTest signed webhook delivery before production activation.
Webhook events
gift.createdrender.readyquote.acceptedorder.submittedorder.shippedorder.deliveredorder.failed