help center
  • Introduction
  • Designs
    • Products
    • Design guides
    • Editing designs
    • Personalize (variables)
    • QR codes
    • Branded Links
    • Images
    • Fonts
    • Scaling text
    • Emojis
    • Finishes
    • Colours
    • Coupons
  • Testing
    • Preview
    • Sample Card
  • API
    • API Documentation
    • Authentication and API Keys
    • Example JSON
    • API status codes
    • Address Validation
    • Rate Limiting
    • Idempotency
    • Postman settings
    • CSV automation
    • Webhooks
  • Integrations
    • ActiveCampaign
    • Deployteq
    • HubSpot
    • Klaviyo
    • Laravel
    • Monday
    • Power Automate
    • Shopify
    • AFAS
    • Spotler / Squeezely
    • Zapier
    • Salesforce
    • Microsoft Dynamics 365
    • Odoo CRM
    • Copernica
    • Zoho
  • Mailing
    • Submission
    • Destinations
    • Sustainability
    • Batch
  • Billing
    • Prepaid
    • Invoice
    • Cost centers
  • Support

help center

English
  • Nederlands
  • English
  • Introduction
  • Designs
    • Products
    • Design guides
    • Editing designs
    • Personalize (variables)
    • QR codes
    • Branded Links
    • Images
    • Fonts
    • Scaling text
    • Emojis
    • Finishes
    • Colours
    • Coupons
  • Testing
    • Preview
    • Sample Card
  • API
    • API Documentation
    • Authentication and API Keys
    • Example JSON
    • API status codes
    • Address Validation
    • Rate Limiting
    • Idempotency
    • Postman settings
    • CSV automation
    • Webhooks
  • Integrations
    • ActiveCampaign
    • Deployteq
    • HubSpot
    • Klaviyo
    • Laravel
    • Monday
    • Power Automate
    • Shopify
    • AFAS
    • Spotler / Squeezely
    • Zapier
    • Salesforce
    • Microsoft Dynamics 365
    • Odoo CRM
    • Copernica
    • Zoho
  • Mailing
    • Submission
    • Destinations
    • Sustainability
    • Batch
  • Billing
    • Prepaid
    • Invoice
    • Cost centers
  • Support

Print.one

  • Print.one website

  • Print.one login

  • Terms and Conditions

Copyright © 2024 Print.one - all rights reserved

  • Api
  • Example JSON

    Example JSON

    Previous

    « Authentication and API Keys

    Next

    API status codes »

    JSON is a way to structure data to be passed to a system, such as Print.one. If you are not yet familiar with JSON, you can view it as a list of keys and values that indicate which information should go where. It is the way you send data to Print.one so that your cards can be automatically personalized.

    Explanation of JSON usage

    Use JSON to include template ID, billing ID, and merge variables.

    Template ID

    Replace 'tmpl_12345678900987654321' with the ID of the template you want to use. The Template ID can be found in the Print.one Portal. Go to ‘Design templates’ in the menu on the left and copy the Template ID next to the title of the correct design.

    Billing ID (optional)

    For 'billingId', you can enter a characteristic, for example, the name of the campaign. You will see this characteristic later in your overviews and on the invoice.

    Merge variables

    Merge variables are the data you want to fill in your template. Does your card contain personalizations, such as a first name or discount code? Then you must include these in the API.

    For example: if you use {{firstname}} in your HTML, this variable will be replaced by the value you include in the JSON with the API call.

    Note: do not use periods in the names of merge variables.

    For more information and examples, see the API documentation.

    Example JSON

    Example JSON:
    1{
    2 "sender": {
    3 "name": "Sender & Co. Ltd",
    4 "address": "Street 123",
    5 "postalCode": "1234AB",
    6 "city": "Amsterdam",
    7 "country": "Netherlands"
    8 },
    9 "recipient": {
    10 "name": "Jane Doe",
    11 "address": "Lane 321",
    12 "postalCode": "4321CD",
    13 "city": "The Hague",
    14 "country": "Netherlands"
    15 },
    16 "mergeVariables": {
    17 "firstname": "Jane",
    18 "discount": "10%",
    19 "coupon code": "DISCOUNT10"
    20 },
    21 "templateId": "tmpl_12345678900987654321",
    22 "finish": "GLOSSY",
    23 "billingId": "Attribute e.g. campaign name for cost allocation"
    24}