GiftsToPrint

Search GiftsToPrint's personalised newspaper-style posters. Each poster shows real headlines and events from one year, personalised with a name, photo and message, and is delivered as a print-ready digital file (nothing is posted). Birthday posters and wedding-anniversary posters exist per milestone and edition (e.g. 60th Birthday, Australian edition, 1966); retirement and dating-anniversary posters cover any year, chosen in the form. Pick the edition by where the recipient lives or grew up (US, UK, Canada or Australia). Returns each matching poster's handle, prices and product page. Next step: get_poster_form.

{
  "type": "object",
  "properties": {
    "occasion": {
      "type": "string",
      "enum": [
        "birthday",
        "wedding_anniversary",
        "dating_anniversary",
        "retirement"
      ],
      "description": "What the poster celebrates."
    },
    "edition": {
      "type": "string",
      "enum": [
        "US",
        "UK",
        "Canada",
        "Australia"
      ],
      "description": "Country edition: which country's news the poster shows."
    },
    "milestone": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "The birthday or anniversary number, e.g. 60 for a 60th."
    },
    "year": {
      "type": "integer",
      "minimum": 1900,
      "maximum": 2100,
      "description": "The year the poster should cover (birth year, or wedding year)."
    },
    "buyer_country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Optional ISO country code of the buyer (e.g. \"US\", \"AU\") to show prices in their currency."
    }
  },
  "additionalProperties": false
}

List exactly what to collect from the user for one poster: names, dates, optional message, and the photo, plus the turnaround options and prices. Ask the user for anything you don't already know. Don't invent names or dates. Next step: upload_photo, then create_poster_checkout.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "The poster's handle, from find_posters."
    },
    "buyer_country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Optional ISO country code of the buyer, for local prices."
    }
  },
  "required": [
    "handle"
  ],
  "additionalProperties": false
}

Store the photo that will be printed on the poster. Give either image_url (a public https link to the image) or image_base64. JPEG, PNG or WebP, up to 20MB. Returns photo_url, which you then pass to create_poster_checkout. Photos are kept for 12 months so the poster can be made and revised, then deleted automatically.

{
  "type": "object",
  "properties": {
    "image_url": {
      "type": "string",
      "format": "uri",
      "description": "Public https:// address of the image."
    },
    "image_base64": {
      "type": "string",
      "description": "The image file encoded as base64 (a data: URL prefix is fine)."
    }
  },
  "additionalProperties": false
}

Validate every detail and create a Shopify checkout for one personalised poster with all the details attached. Returns checkout_url. Nothing is charged: open checkout_url for the user to review the order and pay on GiftsToPrint's own checkout. Before calling, read the details back to the user and confirm they understand they will receive a digital file to print (set confirm_digital_file to true). If a field is wrong, the error lists every problem at once so you can fix them in one go.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "The poster's handle, from find_posters."
    },
    "turnaround": {
      "type": "string",
      "enum": [
        "standard",
        "rush_weekday",
        "rush_weekend"
      ],
      "description": "standard: ready the next working day, order Mon-Fri. rush_weekday: ready within 12 hours, order Mon-Fri. rush_weekend: ready within 24 hours, order Sat or Sun."
    },
    "personalisation": {
      "type": "object",
      "description": "The fields from get_poster_form, keyed by their id (e.g. recipient_first_name, birth_day, birth_month).",
      "additionalProperties": {
        "type": [
          "string",
          "integer"
        ]
      }
    },
    "photo_url": {
      "type": "string",
      "format": "uri",
      "description": "The photo_url returned by upload_photo."
    },
    "buyer": {
      "type": "object",
      "properties": {
        "email": {
          "type": "string",
          "format": "email",
          "description": "The buyer's email. The download link is sent here."
        },
        "first_name": {
          "type": "string",
          "description": "The buyer's first name."
        }
      },
      "required": [
        "email",
        "first_name"
      ],
      "additionalProperties": false
    },
    "buyer_country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Optional ISO country code, so checkout opens in the buyer's currency."
    },
    "instructions": {
      "type": "string",
      "maxLength": 500,
      "description": "Optional note to the designers, e.g. how to crop the photo."
    },
    "confirm_digital_file": {
      "type": "boolean",
      "description": "Must be true: the buyer understands the poster is a digital file to print, not a physical print."
    }
  },
  "required": [
    "handle",
    "turnaround",
    "personalisation",
    "photo_url",
    "buyer",
    "confirm_digital_file"
  ],
  "additionalProperties": false
}