---
title: "Create a new Print-Job (as Reprint)"
method: POST
path: "/print-jobs/ "
tags: ["Print-Jobs"]
---

# Create a new Print-Job (as Reprint)

`POST /print-jobs/ `

## Request

- Base URL: `https://api.lulu.com`
- URL: `https://api.lulu.com/print-jobs/ `
- Auth: OAuth 2
  - Client credentials
  - Implicit: `https://api.lulu.com/auth/realms/glasstree/protocol/openid-connect/auth?nonce=jwt_login`
  - Password
  - Token URL: `https://api.lulu.com/auth/realms/glasstree/protocol/openid-connect/token`
- TypeScript: <https://skmtc.dev/lulu/apis/universal-publishing-platform-api/docs/print-jobs/%E2%80%8A/post.ts> (a function with typed inputs; its response is checked against the schema)

### Usage of printable_id

The immutable `printable_id` can be used for re-orders so that the files don't have to be transferred again.
Given there is an already created and validated Print-Job, you can use the `printable_id` of each line-item
to create re-orders for that particular printable. As the normalized files are already on the server, you
omit the complete `printable_normalization` object from the request and send a valid `printable_id` instead.

### Shipping Information & Metadata

Print-Jobs have to contain a `shipping_address` as well as a `shipping_level`.
Lulu offers five different service levels that differ in speed and traceability.

### Additional Metadata

A few additional metadata fields can be specified in the Print-Job as well:
  * `contact_email` for questions related to the Print-Job itself,
  * `production_delay` allows you to specify a delay (between 60 minutes and 2,880 minutes) before the Print-Job goes to production,
  * `external_id` allows you to link the Print-Job to an internal order number or other reference.

## File Handling and Normalization

If there is an existing printable for the given `printable_id` the already processed and normalized files
are used for production. If there are are problems with the `printable_id`, the PrintJob will be rejected
or cancelled and an error message will be displayed.

## Automation and Payment

After a Print-Job has been created successfully, it will remain in an `UNPAID` state
until it is paid for through the developer portal. However, you can automate the process by putting
a credit card on file. Then, the Print-Job will automatically transition to the `PRODUCTION_DELAY`
status and your card will charged when the Print-Job is sent to production.

## Request body

- object: The job resource that represents a print order
  - `contact_email` string, email, required: Email address that should be contacted if questions regarding the Print-Job arise. Lulu recommends to use the email of a person who is responsible for placing the Print-Job like a developer or business owner.
  - `costs` object: Summary of the costs of a Print-Job
    - `line_item_costs` object: Costs for a Print-Job line item
      - `cost_excl_discounts` string, required: Per unit cost without any discounts applied as a decimal string
      - `discounts` object[], required: Discounts applied to this line item
        - `amount` string, required: The deducted amount as a decimal string
        - `description` string, required: Description of the discount
      - `quantity` number, required: The quantity of printables to base the calculations on
      - `tax_rate` string, required: The tax rate applied to the line as a decimal string
      - `total_cost_excl_discounts` string, required: The total line price without any discounts applied as a decimal string
      - `total_cost_excl_tax` string, required: The total line price including discounts excluding tax as a decimal string
      - `total_cost_incl_tax` string, required: The total line price including discounts and taxes as a decimal string
      - `total_tax` string, required: The total line tax amount as a decimal string
      - `unit_tier_cost` string: Per unit cost with tier discount applied, null for list price (non-tier) customers
    - `shipping_cost` object: Summary of the shipping costs
      - `tax_rate` string: Tax rate that was applied on shipping costs as a decimal string
      - `total_cost_excl_tax` string: Total shipping costs excluding taxes as a decimal string
      - `total_cost_incl_tax` string: Total shipping costs including taxes as a decimal string
      - `total_tax` string: Total amount of taxes on shipping as a decimal string
    - `total_cost_excl_tax` string: Total costs of the job excluding taxes as a decimal string
    - `total_cost_incl_tax` string: Total costs of the job including taxes as a decimal string
    - `total_tax` string: Total amount of taxes on the job as a decimal string
  - `estimated_shipping_dates` object: The estimated ship and delivery dates for a Print-Job
    - `arrival_max` string: The slowest estimated delivery date for a Print-Job in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) format
    - `arrival_min` string: The fastest estimated delivery date for a Print-Job in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) format
    - `dispatch_max` string: The slowest estimated ship date for a Print-Job in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) format
    - `dispatch_min` string: The fastest estimated ship date for a Print-Job in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) format
  - `external_id` string: Arbitrary string to identify and connect a print job to your systems. Set it to an order number, a purchase order or whatever else works for your particular use case.
  - `id` number, required
  - `line_items` object[], required: The line items of a Print-Job, defining it's Printables and their quantities. The property name 'items' can be used instead.
    - `cover` union: Shorthand of the cover source definition. If used together with 'interior' , it can replace 'printable_normalization', Alternatively to both options, a 'printable_id' of an existing printable can be provided.
      - object
        - `source_md5_sum` string: A md5 hash of the source file to check it's integrity
        - `source_url` string, required: The url of the source file.
      - string: The url of the interior source file.
    - `external_id` string: Arbitrary string to identify and connect a print job to your systems. Set it to an order number, a purchase order or whatever else works for your particular use case
    - `id` number, required
    - `interior` union: Shorthand of the interior source definition. If used together with 'cover' , it can replace 'printable_normalization'. Alternatively to both options, a 'printable_id' of an existing printable can be provided.
      - object
        - `source_md5_sum` string: A md5 hash of the source file to check it's integrity
        - `source_url` string, required: The url of the source file.
      - string: The url of the interior source file.
    - `page_count` number: The page count of the printable
    - `pod_package_id` string: The id of the PodPackage of the printable of this line item
    - `printable_id` string, uuid: Id of the Printable of of this line item. It can be used instead of 'printable_normalization' / 'interior' / 'cover'
    - `printable_normalization` object: Can be omitted if a valid 'printable_id' of an existing printable is provided.
      - `cover` object, required: Represents the normalization process of the cover source files
        - `job_id` number: The id of the normalization job (either a InteriorNormalizationJob or a CoverNormalizationJob)
        - `normalized_file` object: The resulting normalized file
          - `file_id` number
          - `filename` string: Filename of the normalized file
        - `source_md5_sum` string: A md5 hash of the source file to check it's integrity
        - `source_url` string, required: The url of the source file.
      - `interior` object, required: Represents the normalization process of the interior source files
        - `job_id` number: The id of the normalization job (either a InteriorNormalizationJob or a CoverNormalizationJob)
        - `normalized_file` object: The resulting normalized file
          - `file_id` number
          - `filename` string: Filename of the normalized file
        - `source_md5_sum` string: A md5 hash of the source file to check it's integrity
        - `source_url` string, required: The url of the source file.
    - `quantity` number, required: Quantity of printed books for this line item
    - `status` object, required: Status object that contains the actual line item processing status as well as additional status related data
      - `messages` object: A map of status related messages / data
        - `delay` string: Expected delay in hours for error status'
        - `error` string: General status error message
        - `info` string: General info message on the status
        - `printable_normalization` object: A map of printable normalization related messages / data
          - `cover` string[]: Array of messages related to the cover file normalization
          - `interior` string[]: Array of messages related to the interior file normalization
        - `timestamp` string: [ISO 8601](https://www.w3.org/TR/NOTE-datetime)) timestamp of last status change
        - `url` union: Tracking url(s)
          - string
          - string[]
      - `name` 'CREATED' | 'ACCEPTED' | 'REJECTED' | 'IN_PRODUCTION' | 'ERROR' | 'SHIPPED', required: The actual processing status of the Print-Job.
    - `title` string: The title of the line item. Should be on the cover. This field will become mandatory on October 1, 2019!
    - `tracking_id` string: A list of tracking ids for this line item's shipment
    - `tracking_urls` string[]: A list of tracking urls for this line item's shipment.
  - `order_id` string: Reference to the order, which this PrintJob has created
  - `production_delay` integer: Delay before a newly created Print-Job is sent to production. Minimum is 60 minutes, maximum is 2880 minutes (=48 hours). As most cancellation requests occur right after an order has been placed, it makes sense to wait for some time before sending an order to production. Once production has started, orders cannot be canceled anymore.
  - `production_due_time` string, date-time: Target timestamp of when this job will move into production ([ISO 8601](https://www.w3.org/TR/NOTE-datetime))
  - `shipping_address` object, required: The shipping address of the customer.
    - `city` string, required
    - `country_code` string, required: [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) country code
    - `email` string, email, required: Shipping carriers require an email address for notifications or handling delivery issues. If no email is given, the default email in the user profile will be used.
    - `is_business` boolean: Only relevant for US addresses. Some US carriers don't deliver to business-addresses on Saturday.
    - `name` string, required: Full name of the person, including first and last name.
    - `organization` string: Name of an organization. Required if no person name is given.
    - `phone_number` string, required: Shipping carriers require a phone number for handling delivery issues. If no phone number is given, the default in the API user profile will be used. Validation Regex Pattern for phone numbers `^\+?[\d\s\-.\/()]{8,20}$`
    - `postcode` string, required: Required for most countries
    - `state_code` string: 2 or 3 letter state codes (officially called [ISO-3166-2 subdivision codes](https://en.wikipedia.org/wiki/ISO_3166-2)). They are required for some countries (e.g. US, MX, CA, AU)
    - `street1` string, required: First address line
    - `street2` string: Second address line
    - `title` 'MR' | 'MISS' | 'MRS' | 'MS' | 'DR'
    - `warnings` object[]: Warnings found during address validation
      - `type` string: Type of warning
      - `code` string: Warning code which describe what was suggested by validation
      - `path` string: Describes the validation origin of warning
      - `message` string: Warning message with suggested change
    - `suggested_address` object: Suggested address returned by shipping address validation
      - `country_code` string: Suggested country code
      - `state_code` string: Suggested state code
      - `postcode` string: Suggested postal code
      - `city` string: Suggested city
      - `street1` string: Suggested first address line
      - `street2` string: Suggested second address line
  - `shipping_level` 'MAIL' | 'PRIORITY_MAIL' | 'GROUND_HD' | 'GROUND_BUS' | 'GROUND' | 'EXPEDITED' | 'EXPRESS', required: The shipping level that this Print-Job is shipped with
  - `tax_country` string: [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the tax country determined for this job

## Response `201`

Created

- object: The job resource that represents a print order
  - `contact_email` string, email, required: Email address that should be contacted if questions regarding the Print-Job arise. Lulu recommends to use the email of a person who is responsible for placing the Print-Job like a developer or business owner.
  - `costs` object: Summary of the costs of a Print-Job
    - `line_item_costs` object: Costs for a Print-Job line item
      - `cost_excl_discounts` string, required: Per unit cost without any discounts applied as a decimal string
      - `discounts` object[], required: Discounts applied to this line item
        - `amount` string, required: The deducted amount as a decimal string
        - `description` string, required: Description of the discount
      - `quantity` number, required: The quantity of printables to base the calculations on
      - `tax_rate` string, required: The tax rate applied to the line as a decimal string
      - `total_cost_excl_discounts` string, required: The total line price without any discounts applied as a decimal string
      - `total_cost_excl_tax` string, required: The total line price including discounts excluding tax as a decimal string
      - `total_cost_incl_tax` string, required: The total line price including discounts and taxes as a decimal string
      - `total_tax` string, required: The total line tax amount as a decimal string
      - `unit_tier_cost` string: Per unit cost with tier discount applied, null for list price (non-tier) customers
    - `shipping_cost` object: Summary of the shipping costs
      - `tax_rate` string: Tax rate that was applied on shipping costs as a decimal string
      - `total_cost_excl_tax` string: Total shipping costs excluding taxes as a decimal string
      - `total_cost_incl_tax` string: Total shipping costs including taxes as a decimal string
      - `total_tax` string: Total amount of taxes on shipping as a decimal string
    - `total_cost_excl_tax` string: Total costs of the job excluding taxes as a decimal string
    - `total_cost_incl_tax` string: Total costs of the job including taxes as a decimal string
    - `total_tax` string: Total amount of taxes on the job as a decimal string
  - `estimated_shipping_dates` object: The estimated ship and delivery dates for a Print-Job
    - `arrival_max` string: The slowest estimated delivery date for a Print-Job in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) format
    - `arrival_min` string: The fastest estimated delivery date for a Print-Job in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) format
    - `dispatch_max` string: The slowest estimated ship date for a Print-Job in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) format
    - `dispatch_min` string: The fastest estimated ship date for a Print-Job in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) format
  - `external_id` string: Arbitrary string to identify and connect a print job to your systems. Set it to an order number, a purchase order or whatever else works for your particular use case.
  - `id` number, required
  - `line_items` object[], required: The line items of a Print-Job, defining it's Printables and their quantities. The property name 'items' can be used instead.
    - `cover` union: Shorthand of the cover source definition. If used together with 'interior' , it can replace 'printable_normalization', Alternatively to both options, a 'printable_id' of an existing printable can be provided.
      - object
        - `source_md5_sum` string: A md5 hash of the source file to check it's integrity
        - `source_url` string, required: The url of the source file.
      - string: The url of the interior source file.
    - `external_id` string: Arbitrary string to identify and connect a print job to your systems. Set it to an order number, a purchase order or whatever else works for your particular use case
    - `id` number, required
    - `interior` union: Shorthand of the interior source definition. If used together with 'cover' , it can replace 'printable_normalization'. Alternatively to both options, a 'printable_id' of an existing printable can be provided.
      - object
        - `source_md5_sum` string: A md5 hash of the source file to check it's integrity
        - `source_url` string, required: The url of the source file.
      - string: The url of the interior source file.
    - `page_count` number: The page count of the printable
    - `pod_package_id` string: The id of the PodPackage of the printable of this line item
    - `printable_id` string, uuid: Id of the Printable of of this line item. It can be used instead of 'printable_normalization' / 'interior' / 'cover'
    - `printable_normalization` object: Represents the normalization processes of the interior and cover source files. Alternatively, 'interior' and 'cover' can be set as a shorthand for creation or a 'printable_id' of an existing printable can be provided.
      - `cover` object, required: Represents the normalization process of the cover source files
        - `job_id` number: The id of the normalization job (either a InteriorNormalizationJob or a CoverNormalizationJob)
        - `normalized_file` object: The resulting normalized file
          - `file_id` number
          - `filename` string: Filename of the normalized file
        - `source_md5_sum` string: A md5 hash of the source file to check it's integrity
        - `source_url` string, required: The url of the source file.
      - `interior` object, required: Represents the normalization process of the interior source files
        - `job_id` number: The id of the normalization job (either a InteriorNormalizationJob or a CoverNormalizationJob)
        - `normalized_file` object: The resulting normalized file
          - `file_id` number
          - `filename` string: Filename of the normalized file
        - `source_md5_sum` string: A md5 hash of the source file to check it's integrity
        - `source_url` string, required: The url of the source file.
    - `quantity` number, required: Quantity of printed books for this line item
    - `status` object, required: Status object that contains the actual line item processing status as well as additional status related data
      - `messages` object: A map of status related messages / data
        - `delay` string: Expected delay in hours for error status'
        - `error` string: General status error message
        - `info` string: General info message on the status
        - `printable_normalization` object: A map of printable normalization related messages / data
          - `cover` string[]: Array of messages related to the cover file normalization
          - `interior` string[]: Array of messages related to the interior file normalization
        - `timestamp` string: [ISO 8601](https://www.w3.org/TR/NOTE-datetime)) timestamp of last status change
        - `url` union: Tracking url(s)
          - string
          - string[]
      - `name` 'CREATED' | 'ACCEPTED' | 'REJECTED' | 'IN_PRODUCTION' | 'ERROR' | 'SHIPPED', required: The actual processing status of the Print-Job.
    - `title` string: The title of the line item. Should be on the cover. This field will become mandatory on October 1, 2019!
    - `tracking_id` string: A list of tracking ids for this line item's shipment
    - `tracking_urls` string[]: A list of tracking urls for this line item's shipment.
  - `order_id` string: Reference to the order, which this PrintJob has created
  - `production_delay` integer: Delay before a newly created Print-Job is sent to production. Minimum is 60 minutes, maximum is 2880 minutes (=48 hours). As most cancellation requests occur right after an order has been placed, it makes sense to wait for some time before sending an order to production. Once production has started, orders cannot be canceled anymore.
  - `production_due_time` string, date-time: Target timestamp of when this job will move into production ([ISO 8601](https://www.w3.org/TR/NOTE-datetime))
  - `shipping_address` object, required: The shipping address of the customer.
    - `city` string, required
    - `country_code` string, required: [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) country code
    - `email` string, email, required: Shipping carriers require an email address for notifications or handling delivery issues. If no email is given, the default email in the user profile will be used.
    - `is_business` boolean: Only relevant for US addresses. Some US carriers don't deliver to business-addresses on Saturday.
    - `name` string, required: Full name of the person, including first and last name.
    - `organization` string: Name of an organization. Required if no person name is given.
    - `phone_number` string, required: Shipping carriers require a phone number for handling delivery issues. If no phone number is given, the default in the API user profile will be used. Validation Regex Pattern for phone numbers `^\+?[\d\s\-.\/()]{8,20}$`
    - `postcode` string, required: Required for most countries
    - `state_code` string: 2 or 3 letter state codes (officially called [ISO-3166-2 subdivision codes](https://en.wikipedia.org/wiki/ISO_3166-2)). They are required for some countries (e.g. US, MX, CA, AU)
    - `street1` string, required: First address line
    - `street2` string: Second address line
    - `title` 'MR' | 'MISS' | 'MRS' | 'MS' | 'DR'
    - `warnings` object[]: Warnings found during address validation
      - `type` string: Type of warning
      - `code` string: Warning code which describe what was suggested by validation
      - `path` string: Describes the validation origin of warning
      - `message` string: Warning message with suggested change
    - `suggested_address` object: Suggested address returned by shipping address validation
      - `country_code` string: Suggested country code
      - `state_code` string: Suggested state code
      - `postcode` string: Suggested postal code
      - `city` string: Suggested city
      - `street1` string: Suggested first address line
      - `street2` string: Suggested second address line
  - `shipping_level` 'MAIL' | 'PRIORITY_MAIL' | 'GROUND_HD' | 'GROUND_BUS' | 'GROUND' | 'EXPEDITED' | 'EXPRESS', required: The shipping level that this Print-Job is shipped with
  - `tax_country` string: [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the tax country determined for this job

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-09-30** `fa5a6116f26b`: 5 warning
  - the `shipping_address/city` request property's maxLength was set to `30`
  - the `shipping_address/name` request property's maxLength was set to `35`
  - the `shipping_address/organization` request property's maxLength was set to `30`
  - the `shipping_address/street1` request property's maxLength was set to `30`
  - …1 more
- **2026-09-01** `3119f71811f8`: 1 info
  - the `line_items/items/pod_package_id` request property's maxLength was increased from `27` to `100`
- **2024-08-22** `692a2290ef22`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lulu/apis/universal-publishing-platform-api/changes/print-jobs/%E2%80%8A/post.md)

---

[API](https://skmtc.dev/lulu/apis/universal-publishing-platform-api.md) - [All operations](https://skmtc.dev/lulu/apis/universal-publishing-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lulu/apis/universal-publishing-platform-api/revisions/fa5a6116f26b?raw)