Generate Multi-Format PDFs for Printing

Asynchronously generate print-ready PDFs across multiple formats from a single Print design. Each PDF is exported with CMYK color space support and bleed settings configured in your design — ready to send directly to a print supplier.

Each format produces one PDF file. Results are delivered as a ZIP archive via a NEW_BANNER_BATCH webhook event to your callback_url. For a single document with multiple pages, use Generate Multi-Page PDF instead.

INFO

This feature is available from the Suite plan.

Endpoint

POST/async/banner-builder/{designId}/generateAPI Reference

Generation Characteristics

• Supported Design Type: Print
• Response: Asynchronous
• Output: Single-page printable PDF per format
• Retrieval methods: Webhooks, Polling

Output Customization

Use the print property to customize the PDF output:

Display Crop Marks

• Default: the value configured in the builder
• Type: Boolean

Color Profiles

UUID	Description
be2ab219-8fe4-4d85-91ba-65bdc9ddaf01	CMYK — ISO Coated v2 (ECI)
03738f37-5b6f-4be9-9100-706b1711f9dd	CMYK — ISO Coated v2 (ECI) 300%
e0c86a8a-050c-41f1-885a-0f74b9baac50	CMYK — ISO Uncoated
0e0355e6-2931-4c83-92f2-64db9f5ddffc	CMYK — US Web Coated (SWOP 2006 5v2)
db3c123e-1127-11ef-b77e-f93002785645	RGB — No color profile
fac91df8-1155-11ef-b77e-f93002785645	CMYK — ISO Newspaper26 v4

{
  "print": {
    "display_crop_marks": true,
    "color_profile": "e0c86a8a-050c-41f1-885a-0f74b9baac50"
  }
}

Sample Request

Replace {YOUR-API-KEY} and {designId} before running.

curl -X POST \
  -H "x-api-key: {YOUR-API-KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "callback_url": "https://webhook.mycompany.com/pdfs",
    "template_format_names": ["postcard", "tabloid-vertical"],
    "elements": {
      "root": { "background_color": "cmyk(0,0,0,0)" },
      "text_0": {
        "payload": "Lorem ipsum",
        "color": "cmyka(0,0,0,100,100)",
        "font_size": 24,
        "font_weight": 400,
        "line_height": 130,
        "alignment": "top left"
      }
    }
  }' \
  https://api.abyssale.com/async/banner-builder/{designId}/generate

Sample Response

{ "generation_request_id": "166e1852-dc97-43e3-a5f2-142076452c74" }

Related

• Asynchronous Generation Overview
• Root Element Properties — CMYK background color for print
• Banner Events — webhook payload on completion
• Errors — error codes for failed requests