Printago API
POST /v1/customizer/configs/{configId}/shopify-publication

Publish customizer config to Shopify

Publish the config to Shopify. Embed mode writes the `printago.sku_id` metafield on the chosen product (the only product write — listings are never created or overwritten) so the theme app extension block renders the customizer there. Direct mode exposes the app-proxy customizer URL as a standalone storefront page.

Requires: customizer.manage

Path Parameters

configId required
string

Request Body

CustomizerPublishBody
integrationIdoptional
string
pattern: ^[a-z0-9]{24}$
moderequired
any
shopifyProductHandleoptional
string
shopifyProductIdoptional
string

Example Request

application/json 
{
  "integrationId": "string",
  "shopifyProductId": "string",
  "shopifyProductHandle": "string"
}

Response Schema

CustomizerPublicationState
directUrlrequired
string
Storefront URL for the direct-to-customizer page (app proxy).
integrationrequired
object
productCandidatesrequired
object[]
handlerequired
string
productIdrequired
string
statusrequired
string
titlerequired
string
publicationrequired
object
skuCoderequired
string
skuIdrequired
string
themeEditorUrlrequired
string
Theme-editor deep link that pre-adds the customizer block.

Example Response

201 OK — application/json 
{
  "productCandidates": [
    {
      "productId": "string",
      "title": "string",
      "handle": "string",
      "status": "string"
    }
  ]
}