list_packaging_models
Find a packaging model
Browse the packaging you can design on Creadal: boxes, pouches, bottle and jar labels, cans, cups, bags, sacks, pillow packs, mugs, t-shirts, tote bags, keychains and sneakers. Each model comes with its sizes, a photo-real preview picture and its page. Use it to pick the model for create_packaging_design or to show someone what is possible. Free, no account needed.
Parametersquerycategorylanguage
generate_dieline
Make a dieline
Give the size of a box, label, pouch, sack or pillow pack in millimetres and get its print-ready dieline (cut and fold lines, bleed) as PDF and SVG links, ready for the printer or any design software. Same engine as the free dieline generator on creadal.com. Free, no account needed. Sizes: box = length, width, height; label (wraps a bottle or jar) = diameter, height; pouch = width, height, optional gusset; sack = width, height, optional gusset; pillow = width, height, optional depth.
Parameterskindrequireddepthwidthgussetheightlengthoverlapdiameter
create_packaging_design
Design packaging
Tell it the product and the packaging, and get a finished packaging design in the member's Creadal account: a professionally laid-out ready design for that model with the brand, product name and label facts filled in, a preview picture, the 3D look, a print PDF link and a link to open it in the Creadal editor. Optionally makes a product photo with AI for the label (that uses one AI image from the member's plan). Pick the model with list_packaging_models (id or slug).
Parametersmodelrequiredstoragetaglinewebsitelanguagebrand_namedirectionsbest_beforedescriptioningredientsmanufacturernet_quantity+3 more
list_my_designs
List my designs
The member's latest Creadal designs in the connected workspace, newest first, each with a link to open it in the editor.
Parameterslimit
One of the member's designs: its title, a preview picture and links to open it in the editor and to download its print PDF.
ParametersdesignIdrequired
export_print_pdf
Get the print PDF
A download link for a design's print-ready PDF (and a PNG), valid for 24 hours, to send to a printer or keep.
ParametersdesignIdrequired
The member's Creadal plan and what is left of it this period (AI images, AI video seconds), with a link to upgrade.
Takes no parameters.
create_social_design
Design a social post or ad
Make a social media post or ad in the member's Creadal account from a professionally designed ready template: headline, supporting line, offer, call-to-action button, brand and website filled in, the member's own picture (a product photo or an app or website screenshot, given as a public https link) placed in the template's picture frame, and their logo (a public https link, PNG with transparency is best) in place of the brand name. Returns a preview picture and a link to open and edit it in the Creadal editor. Use this, not generate_presentation, for posts, stories and ads. Optionally makes the picture with AI instead (uses one AI image from the member's plan).
Parametersctaofferformatkickerwebsiteheadlinerequiredlanguagelogo_urlimage_fitimage_urlbrand_namedescription+3 more
generate_presentation
Generate a presentation
Generate a complete, editable presentation or document from a prompt (for a social post, story or ad use create_social_design instead: it starts from a designed template and places the member's own picture and logo). Waits for the result when generation is quick; otherwise returns a job to poll with get_job. The composed deck contains laid-out text, a theme, and speaker notes; per-slide images are generated in the creadal editor. Requires the 'generate' scope.
ParametersmotionpromptrequiredsourcesthemeIdlanguagepageCountdesignTypetemplateIdbrandPalette
get_job
Check a generation job
Poll a generation or export job by id. A completed generation job's result carries designId and editorUrl.
ParametersjobIdrequired
list_templates
List templates
List the templates visible to this key's workspace (built-ins and workspace templates). Pass an id as generate_presentation's templateId to compose on that template's layout system and theme.
Parametersquery
List the built-in theme catalog (id, name, style group, six palette slots, font pair). Pass an id as generate_presentation's themeId.
Takes no parameters.
get_design_file
Get a design file
Fetch a design's open-format file (creadal.desing JSON): pages, nodes, theme, speaker notes. Large files are summarized instead of inlined. Requires the 'read' scope.
ParametersdesignIdrequired
export_design
Export a design
Get download URLs for a design's server-side exports (PDF and PNG). Fetch them with the same Authorization bearer key. Requires the 'export' scope.
ParametersdesignIdrequired
create_share_link
Create a share link
Create a share link for a design (view/comment/edit, optional password, expiry, and audience label for per-link analytics). Returns the share URL and the ?embed=1 iframe URL. Requires the 'export' scope.
ParametersmodelabeldesignIdrequiredpasswordexpiresAt