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-pages

Create the recipient page with photo, message, occasion and Gift Pass.

POST /v1/renders

Generate visible proof, AI assets and print-ready files when applicable.

POST /v1/quotes

Quote products, shipping, SLA, estimated taxes, provider and margin.

POST /v1/orders

Submit a live order after app approval, payment and content validation.

POST /v1/webhooks/test

Test signed webhook delivery before production activation.

Webhook events

gift.createdrender.readyquote.acceptedorder.submittedorder.shippedorder.deliveredorder.failed