Notification Outputs

Notification outputs allow you to define the method of notification delivery

Each notification you create in Smart Order Notifications will have a notification output

Email

The email output sends your notification to one or more email address. As shown below you can semicolon separate addresses in the the Email addresses field to sent to multiple recipients. You can also use the {{ email }} Liquid drop in this field to send emails to the customer listed on the order and another email address of your choosing. The email content will be determined by the email template associated with the notification.

Customer Email

The customer email output will send the notification to the customer email on the order in question. If the order has no email associated with it then the notification will not be sent.

Caution Required It's rare that the customer email output will be used with the scheduled, batch notification feature of Smart Order Notifications. This is because you rarely want all order data to go to each customer in the batch. It is possible that you could accidentally share sensitive customer data by using the customer email output in combination with batch notifications. For this reason we recommend that this is only used with immediate notifications.

Email with attachment

This output type is identical to the email output, in that you can send to one or many addresses, but it adds a plain text attachment to the email. The email template determines the content of the email itself and the attachment template determines the content of the attachment file.

Webhook

Webhook notifications send a payload of JSON data to a specified endpoint via https. This endpoint is specified by you in the notification output settings:

The payload that's sent from Smart Order Notifications takes a similar shape to that sent in Shopify's webhooks. However, we make some additions, for example, adding bundle items to line items for our Bundles app integration customers. Please see an example webhook payload below but if you need any further advice on consuming our webhooks, please don't hesitate to ask.

{
  "orders": [
    {
      "id": 111111111111,
      "name": "#1360",
      "note": "VIP customer",
      "tags": "VIP, Customer Service Request",
      "test": false,
      "email": "steve@example.com",
      "phone": null,
      "token": "6430d6fd2522e0966d9ad5fb0b4b9895",
      "app_id": 1111111,
      "number": 360,
      "gateway": "manual",
      "refunds": [],
      "user_id": 111111111,
      "currency": "GBP",
      "customer": {
        "id": 111111111111,
        "note": "",
        "tags": "VIP",
        "email": "steve@example.com",
        "phone": null,
        "state": "enabled",
        "currency": "GBP",
        "last_name": "",
        "created_at": "2018-05-16T13:58:45+01:00",
        "first_name": "Steve Jobs",
        "tax_exempt": true,
        "updated_at": "2021-06-15T14:05:37+01:00",
        "total_spent": "416483.41",
        "orders_count": 63,
        "last_order_id": 111111111111,
        "tax_exemptions": [],
        "verified_email": true,
        "default_address": {
          "id": 111111111111,
          "zip": "E1 2JS",
          "city": "London",
          "name": "Steve Jobs",
          "phone": null,
          "company": null,
          "country": "United Kingdom",
          "default": true,
          "address1": "123 Ecommerce street",
          "address2": "",
          "province": "England",
          "last_name": "Jobs",
          "first_name": "Steve",
          "customer_id": 111111111111,
          "country_code": "GB",
          "country_name": "United Kingdom",
          "province_code": "ENG"
        },
        "last_order_name": "#1370",
        "accepts_marketing": false,
        "admin_graphql_api_id": "gid://shopify/Customer/111111111111",
        "multipass_identifier": null,
        "marketing_opt_in_level": null,
        "accepts_marketing_updated_at": "2019-01-06T08:48:18+00:00"
      },
      "closed_at": null,
      "confirmed": true,
      "device_id": null,
      "reference": null,
      "tax_lines": [],
      "total_tax": "0.00",
      "browser_ip": null,
      "cart_token": null,
      "created_at": "2021-05-21T10:01:49+01:00",
      "line_items": [
        {
          "id": 111111111111,
          "sku": "",
          "name": "Black Leather Bag",
          "grams": 0,
          "price": "0.00",
          "title": "Black Leather Bag",
          "duties": [],
          "vendor": "Liam Fashions",
          "taxable": true,
          "quantity": 1,
          "gift_card": false,
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "GBP"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "GBP"
            }
          },
          "tax_lines": [],
          "product_id": 111111111111,
          "properties": {},
          "variant_id": 111111111111,
          "variant_title": null,
          "product_exists": true,
          "total_discount": "0.00",
          "requires_shipping": true,
          "fulfillment_status": null,
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "GBP"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "GBP"
            }
          },
          "fulfillment_service": "manual",
          "admin_graphql_api_id": "gid://shopify/LineItem/111111111111",
          "discount_allocations": [],
          "fulfillable_quantity": 1,
          "variant_inventory_management": "shopify",
          "line_price": "0.00",
          "original_line_price": "0.00",
          "final_line_price": "0.00",
          "product": {
            "id": 111111111111,
            "tags": "women",
            "image": {
              "id": 111111111111,
              "alt": "new alt tag content",
              "src": "https://cdn.shopify.com/s/files/1/1973/6725/products/black-bag-over-the-shoulder_925x_d43924d9-4380-4239-893b-d72632ca96b3.jpg?v=1620918919",
              "width": 925,
              "height": 617,
              "position": 1,
              "created_at": "2019-06-05T09:43:43+01:00",
              "product_id": 111111111111,
              "updated_at": "2021-05-13T16:15:19+01:00",
              "variant_ids": [],
              "admin_graphql_api_id": "gid://shopify/ProductImage/111111111111"
            },
            "title": "Black Leather Bag",
            "handle": "black-leather-bag-1",
            "images": [
              {
                "id": 4422795984952,
                "alt": "Black leather bag",
                "src": "https://cdn.shopify.com/s/files/1/1973/6725/products/black-bag-over-the-shoulder_925x_d43924d9-4380-4239-893b-d72632ca96b3.jpg?v=1620918919",
                "width": 925,
                "height": 617,
                "position": 1,
                "created_at": "2019-06-05T09:43:43+01:00",
                "product_id": 111111111111,
                "updated_at": "2021-05-13T16:15:19+01:00",
                "variant_ids": [],
                "admin_graphql_api_id": "gid://shopify/ProductImage/111111111111"
              }
            ],
            "status": "active",
            "vendor": "Liam Fashions",
            "options": [
              {
                "id": 111111111111,
                "name": "Title",
                "values": [
                  "Default Title"
                ],
                "position": 1,
                "product_id": 111111111111
              }
            ],
            "variants": [
              {
                "id": 111111111111,
                "sku": "",
                "grams": 0,
                "price": "0.00",
                "title": "Default Title",
                "weight": 0,
                "barcode": "",
                "option1": "Default Title",
                "option2": null,
                "option3": null,
                "taxable": true,
                "image_id": null,
                "position": 1,
                "created_at": "2019-06-05T09:43:43+01:00",
                "product_id": 111111111111,
                "updated_at": "2021-06-15T11:44:35+01:00",
                "weight_unit": "g",
                "compare_at_price": null,
                "inventory_policy": "continue",
                "inventory_item_id": 111111111111,
                "requires_shipping": true,
                "inventory_quantity": 228,
                "fulfillment_service": "manual",
                "admin_graphql_api_id": "gid://shopify/ProductVariant/111111111111",
                "inventory_management": "shopify",
                "old_inventory_quantity": 228
              }
            ],
            "body_html": "Womens black leather bag, with ample space. Can be worn over the shoulder, or remove straps to carry in your hand.",
            "created_at": "2019-06-05T09:43:43+01:00",
            "updated_at": "2021-06-15T11:44:35+01:00",
            "product_type": "",
            "published_at": "2019-06-05T09:43:42+01:00",
            "published_scope": "global",
            "template_suffix": null,
            "admin_graphql_api_id": "gid://shopify/Product/1971672383544"
          },
          "variant": {
            "id": 111111111111,
            "sku": "",
            "grams": 0,
            "price": "0.00",
            "title": "Default Title",
            "weight": 0,
            "barcode": "",
            "option1": "Default Title",
            "option2": null,
            "option3": null,
            "taxable": true,
            "image_id": null,
            "position": 1,
            "created_at": "2019-06-05T09:43:43+01:00",
            "product_id": 111111111111,
            "updated_at": "2021-06-15T11:44:35+01:00",
            "weight_unit": "g",
            "compare_at_price": null,
            "inventory_policy": "continue",
            "inventory_item_id": 111111111111,
            "requires_shipping": true,
            "inventory_quantity": 228,
            "fulfillment_service": "manual",
            "admin_graphql_api_id": "gid://shopify/ProductVariant/111111111111",
            "inventory_management": "shopify",
            "old_inventory_quantity": 228
          },
          "image": "https://cdn.shopify.com/s/files/1/1973/6725/products/black-bag-over-the-shoulder_925x_d43924d9-4380-4239-893b-d72632ca96b3.jpg?v=1620918919",
          "is_bundle": false
        },
        {
          "id": 111111111111,
          "sku": "",
          "name": "Star Wars Rouge One Lego AT-ST Walker set - Starter Kit",
          "grams": 500,
          "price": "39.00",
          "title": "Star Wars Rouge One Lego AT-ST Walker set",
          "duties": [],
          "vendor": "Lego",
          "taxable": true,
          "quantity": 1,
          "gift_card": false,
          "price_set": {
            "shop_money": {
              "amount": "39.00",
              "currency_code": "GBP"
            },
            "presentment_money": {
              "amount": "39.00",
              "currency_code": "GBP"
            }
          },
          "tax_lines": [],
          "product_id": 111111111111,
          "properties": {},
          "variant_id": 111111111111,
          "variant_title": "'+ Starter Kit",
          "product_exists": true,
          "total_discount": "0.00",
          "requires_shipping": true,
          "fulfillment_status": null,
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "GBP"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "GBP"
            }
          },
          "fulfillment_service": "manual",
          "admin_graphql_api_id": "gid://shopify/LineItem/111111111111",
          "discount_allocations": [],
          "fulfillable_quantity": 1,
          "variant_inventory_management": null,
          "line_price": "39.00",
          "original_line_price": "39.00",
          "final_line_price": "39.00",
          "product": {
            "id": 111111111111,
            "tags": "AT-ST, blah, collection-visible, Empire, flash, lego, rouge one, star wars",
            "image": {
              "id": 111111111111,
              "alt": null,
              "src": "https://cdn.shopify.com/s/files/1/1973/6725/products/LEGO-Rogue-One-AT-ST-Walker-75153-Box.jpg?v=1578607681",
              "width": 1000,
              "height": 1000,
              "position": 1,
              "created_at": "2017-05-02T18:50:55+01:00",
              "product_id": 111111111111,
              "updated_at": "2020-01-09T22:08:01+00:00",
              "variant_ids": [],
              "admin_graphql_api_id": "gid://shopify/ProductImage/23142608258"
            },
            "title": "Star Wars Rouge One Lego AT-ST Walker set 🕺",
            "handle": "star-wars-rouge-one-lego-at-st-walker-set",
            "images": [
              {
                "id": 111111111111,
                "alt": null,
                "src": "https://cdn.shopify.com/s/files/1/1973/6725/products/LEGO-Rogue-One-AT-ST-Walker-75153-Box.jpg?v=1578607681",
                "width": 1000,
                "height": 1000,
                "position": 1,
                "created_at": "2017-05-02T18:50:55+01:00",
                "product_id": 111111111111,
                "updated_at": "2020-01-09T22:08:01+00:00",
                "variant_ids": [],
                "admin_graphql_api_id": "gid://shopify/ProductImage/23142608258"
              },
              {
                "id": 111111111111,
                "alt": null,
                "src": "https://cdn.shopify.com/s/files/1/1973/6725/products/2016-LEGO-Star-Wars-AT-ST-Walker-Rogue-One-Set.jpg?v=1578607681",
                "width": 1000,
                "height": 1324,
                "position": 2,
                "created_at": "2017-05-02T18:51:01+01:00",
                "product_id": 111111111111,
                "updated_at": "2020-01-09T22:08:01+00:00",
                "variant_ids": [],
                "admin_graphql_api_id": "gid://shopify/ProductImage/23142608322"
              }
            ],
            "status": "active",
            "vendor": "Lego",
            "options": [
              {
                "id": 111111111111,
                "name": "Type",
                "values": [
                  "Standard",
                  "'+ Starter Kit"
                ],
                "position": 1,
                "product_id": 111111111111
              }
            ],
            "variants": [
              {
                "id": 111111111111,
                "sku": "",
                "grams": 500,
                "price": "19.95",
                "title": "Standard",
                "weight": 500,
                "barcode": "",
                "option1": "Standard",
                "option2": null,
                "option3": null,
                "taxable": true,
                "image_id": null,
                "position": 1,
                "created_at": "2017-05-02T18:50:43+01:00",
                "product_id": 9579367362,
                "updated_at": "2021-05-21T10:08:35+01:00",
                "weight_unit": "g",
                "compare_at_price": null,
                "inventory_policy": "deny",
                "inventory_item_id": 111111111111,
                "requires_shipping": true,
                "inventory_quantity": 6,
                "fulfillment_service": "manual",
                "admin_graphql_api_id": "gid://shopify/ProductVariant/111111111111",
                "inventory_management": "shopify",
                "old_inventory_quantity": 6
              },
              {
                "id": 111111111111,
                "sku": "",
                "grams": 500,
                "price": "39.00",
                "title": "'+ Starter Kit",
                "weight": 500,
                "barcode": null,
                "option1": "'+ Starter Kit",
                "option2": null,
                "option3": null,
                "taxable": true,
                "image_id": null,
                "position": 2,
                "created_at": "2017-07-12T11:53:18+01:00",
                "product_id": 111111111111,
                "updated_at": "2021-05-21T10:01:50+01:00",
                "weight_unit": "g",
                "compare_at_price": null,
                "inventory_policy": "deny",
                "inventory_item_id": 111111111111,
                "requires_shipping": true,
                "inventory_quantity": -4,
                "fulfillment_service": "manual",
                "admin_graphql_api_id": "gid://shopify/ProductVariant/111111111111",
                "inventory_management": null,
                "old_inventory_quantity": -4
              }
            ],
            "body_html": "Star Wars Lego",
            "created_at": "2017-05-02T18:50:43+01:00",
            "updated_at": "2021-05-21T10:10:02+01:00",
            "product_type": "Lego",
            "published_at": null,
            "published_scope": "web",
            "template_suffix": null,
            "admin_graphql_api_id": "gid://shopify/Product/111111111111"
          },
          "variant": {
            "id": 111111111111,
            "sku": "",
            "grams": 500,
            "price": "39.00",
            "title": "'+ Starter Kit",
            "weight": 500,
            "barcode": null,
            "option1": "'+ Starter Kit",
            "option2": null,
            "option3": null,
            "taxable": true,
            "image_id": null,
            "position": 2,
            "created_at": "2017-07-12T11:53:18+01:00",
            "product_id": 111111111111,
            "updated_at": "2021-05-21T10:01:50+01:00",
            "weight_unit": "g",
            "compare_at_price": null,
            "inventory_policy": "deny",
            "inventory_item_id": 111111111111,
            "requires_shipping": true,
            "inventory_quantity": -4,
            "fulfillment_service": "manual",
            "admin_graphql_api_id": "gid://shopify/ProductVariant/38565779906",
            "inventory_management": null,
            "old_inventory_quantity": -4
          },
          "image": "https://cdn.shopify.com/s/files/1/1973/6725/products/LEGO-Rogue-One-AT-ST-Walker-75153-Box.jpg?v=1578607681",
          "is_bundle": false
        }
      ],
      "source_url": null,
      "updated_at": "2021-06-30T13:25:24+01:00",
      "checkout_id": null,
      "location_id": null,
      "source_name": "shopify_draft_order",
      "total_price": "39.00",
      "cancelled_at": null,
      "fulfillments": [],
      "landing_site": null,
      "order_number": 1360,
      "processed_at": "2021-05-21T10:01:49+01:00",
      "total_weight": 500,
      "cancel_reason": null,
      "contact_email": "steve@example.com",
      "total_tax_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "GBP"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "GBP"
        }
      },
      "checkout_token": null,
      "discount_codes": [],
      "referring_site": null,
      "shipping_lines": [],
      "subtotal_price": "39.00",
      "taxes_included": true,
      "billing_address": {
        "zip": "E1 2JS",
        "city": "London",
        "name": "Steve Jobs",
        "phone": null,
        "company": null,
        "country": "United Kingdom",
        "address1": "123 Ecommerce street",
        "address2": "",
        "latitude": 51.5202265,
        "province": "England",
        "last_name": "Jobs",
        "longitude": -0.07446849999999999,
        "first_name": "Steve",
        "country_code": "GB",
        "province_code": "ENG"
      },
      "customer_locale": "en",
      "note_attributes": [],
      "total_discounts": "0.00",
      "total_price_set": {
        "shop_money": {
          "amount": "39.00",
          "currency_code": "GBP"
        },
        "presentment_money": {
          "amount": "39.00",
          "currency_code": "GBP"
        }
      },
      "total_price_usd": "55.01",
      "financial_status": "paid",
      "landing_site_ref": null,
      "order_status_url": "https://example.myshopify.com/19736725/order...",
      "shipping_address": {
        "zip": "E1 2JS",
        "city": "London",
        "name": "Steve Jobs",
        "phone": null,
        "company": null,
        "country": "United Kingdom",
        "address1": "123 Ecommerce street",
        "address2": "",
        "latitude": 51.5202265,
        "province": "England",
        "last_name": "Jobs",
        "longitude": -0.07446849999999999,
        "first_name": "Steve",
        "country_code": "GB",
        "province_code": "ENG"
      },
      "current_total_tax": "0.00",
      "processing_method": "manual",
      "source_identifier": null,
      "total_outstanding": "0.00",
      "fulfillment_status": null,
      "subtotal_price_set": {
        "shop_money": {
          "amount": "39.00",
          "currency_code": "GBP"
        },
        "presentment_money": {
          "amount": "39.00",
          "currency_code": "GBP"
        }
      },
      "total_tip_received": "0.00",
      "current_total_price": "39.00",
      "total_discounts_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "GBP"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "GBP"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/111111111111",
      "presentment_currency": "GBP",
      "current_total_tax_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "GBP"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "GBP"
        }
      },
      "discount_applications": [],
      "payment_gateway_names": [
        "manual"
      ],
      "current_subtotal_price": "39.00",
      "total_line_items_price": "39.00",
      "buyer_accepts_marketing": false,
      "current_total_discounts": "0.00",
      "current_total_price_set": {
        "shop_money": {
          "amount": "39.00",
          "currency_code": "GBP"
        },
        "presentment_money": {
          "amount": "39.00",
          "currency_code": "GBP"
        }
      },
      "current_total_duties_set": null,
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "GBP"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "GBP"
        }
      },
      "original_total_duties_set": null,
      "current_subtotal_price_set": {
        "shop_money": {
          "amount": "39.00",
          "currency_code": "GBP"
        },
        "presentment_money": {
          "amount": "39.00",
          "currency_code": "GBP"
        }
      },
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "39.00",
          "currency_code": "GBP"
        },
        "presentment_money": {
          "amount": "39.00",
          "currency_code": "GBP"
        }
      },
      "current_total_discounts_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "GBP"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "GBP"
        }
      },
      "order_name": "#1360",
      "shipping_price": "0.00",
      "shipping_method": null,
      "requires_shipping": true,
      "transactions": [
        {
          "id": 111111111111,
          "kind": "sale",
          "test": false,
          "amount": "39.00",
          "status": "success",
          "gateway": "manual",
          "message": "Marked the manual payment as received",
          "receipt": {},
          "user_id": null,
          "currency": "GBP",
          "device_id": null,
          "parent_id": null,
          "created_at": "2021-05-21T10:01:49+01:00",
          "error_code": null,
          "location_id": null,
          "source_name": "1830279",
          "processed_at": "2021-05-21T10:01:49+01:00",
          "authorization": null,
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/111111111111"
        }
      ],
      "metafields": {},
      "attributes": {}
    }
  ]
}

Last updated