Webhook Details Sent to Delivery URL

This article assumes you have read and enabled the webhooks, please refer this article for more info: https://nector.crisp.help/en/article/webhooks

Various webhook events on nector

Some of the common webhooks fired from nector

When customer is created or updated - lead_create and lead_update

When coupon is created or updated - coupon_create and coupon_update

When order is created or updated - order_create and order_update

When wallet transaction is created or updated - walletreward_create and wallettrasaction_update

When review is created or updated - review_create and review_update

When customer's VIP tier changes - viptier_create

A few other webhooks fired from nector

When review request is being sent after the order is placed - reviewrequest_create

When incomplete referral nudge is being sent to the referee - incompletereferralrequest_create

When unused coupon nudge is being sent - unusedcouponrequest_create

When unused coin nudge is being sent - unusedwalletcoinrequest_create

When coin expiry nudge is being sent - coinexpirynotify_create

When the referee has to be notified about their referral discount - refereenotify_create

When the referral is completed and referrer has to be notified about it - referrernotify_create

Common webhook header sent on every webhook

"accept": "application/json",
"content-type": "application/json",
"x-source": "unix",
"x-nector-webhook-hmac-algo": "sha256",
"x-nector-webhook-hmac": "gwgsdfwdv3468", // for payload sanity check
"x-nector-webhook-secret-algo": "sha256",
"x-nector-webhook-secret": "36473512374shdh346", sha256 of webhook secret
"x-nector-timestamp": "535363633", // unix timestamp
"x-nector-delivery-id": "723dg342", // unique delivery id
"x-nector-topic": "walletreward_create" // webhook topic

Common webhook data sent on every webhook

You might receive more properties in the webhook data payload than listed below

business_name: "name of the business (string)",
business_uri: "website url of the business (string)",
nector_business_uri: "website url of the business (string)",
business_coin_name: "coin name (string)",
business_currency_code: "currency code (string)",
business_currency_symbol: "currency symbol (string)",

If the event on nector has customer details in it, then customer details will be sent too in the webhook data payload.

user_customer_id: "user's customer id on host platform (string)",
user_name: "user's name (string)",
user_email: "user's email (string)",
user_mobile: "user's mobile (string)",
user_tier: "user's tier (string)",
user_type: "user's type (string)",
user_referral_code: "referral code of the user (string)",
user_referred_by_referral_code: "referral code of the customer who referred this customer (string)",
user_referral_link: "referral link of the customer (string)",
user_new_referral_link: "referral link of the customer (string)",
user_available_balance: "coin balance of the user (number)",
user_balance: "coin balance of the user (number)",
user_dob: "dob of the user in DD-MM format (string)",
user_full_dob: "dob of the user in DD-MM-YYYY format (string)",
user_country: "user's country (string)",
user_transaction_amount: "total order amount (number)"

Extra webhook data specific to lead_create, lead_update

You might receive more properties in the webhook data payload than listed below

entity_id: '449ebf4f-f3e2-471a-a21f-47d8e148f259',
referral_code: '2nfcdqo46x',
customer_id: 'shopify-7029064106277',
referred_by_referral_code: '',
name: 'Ayush Shukla',
available: 0,
tier: '',
type: 'member',
classification: '',
transaction_amount: '',
last_transaction: '',
accept_email: true,
accept_mobile: true,
accept_smartdiscountapply: '',
dob: '',
full_dob: '',
mid: '',
mobile: '',
country: '',
eid: '206f22037f5bbea617f616fdfe3f643874c6254863af7efed7c08ad75069a4e5',
email: 'ayush+fri26may@nector.io',
email_status: 'pending',
is_freezed: '',
created_at: '2023-05-26T07:44:03.862Z',
updated_at: '2023-05-26T07:44:03.862Z'

Extra webhook data specific to coupon_create, coupon_update, and unusedcouponrequest_create

You might receive more properties in the webhook data payload than listed below

entity_id: '449ebf4f-f3e2-471a-a21f-47d8e148f259',
lead_id: '19c794f5-5ba6-4bf9-b30b-8666ae71d324',
activity_id: '',
offer_id: 'd652a88e-2317-40ea-8369-9fe8463a7d3d',
reference_coupon_id: '40ea40ea::40ea40ea',
reference_coupon_source: 'shopify',
name: '2% Off coupon',
description: 'Minimum cart amount of ₹499',
type: 'manual_redeem',
value: 'TWOOFFVERYGOOD',
fiat_class: 'percent',
fiat_value: 2,
fiat_target: 'cart',
minimumcart_amount: 499,
meta: {
  lead_name: 'Ayush Shukla'
},
status: 'issued',
redirect_link: 'https://nector-dev-store-99.myshopify.com/discount/TWOOFFVERYGOOD?utm_source=nector&utm_medium=email&utm_campaign=transactional',
expire: '2023-06-02T06:40:33.470Z',
formatted_expire: 'June 2nd 2023, 6:40:33 am',
updated_at: '2023-05-18T06:40:34.898Z',
created_at: '2023-05-18T06:40:33.472Z'

Extra webhook data specific to walletreward_create, wallettrasaction_update, and unusedwalletcoinrequest_create

You might receive more properties in the webhook data payload than listed below

entity_id: '449ebf4f-f3e2-471a-a21f-47d8e148f259',
lead_id: '19c794f5-5ba6-4bf9-b30b-8666ae71d324',
activity_id: '',
title: 'Test Reward',
description: '',
amount: 1,
closing_balance: 1,
consolidated_cr: 1,
consolidated_dr: 0,
hash: '98f49c894265d162dd8d2e1dbee0fffe9fc4445d',
meta: {
  lead_name: 'Ayush Shukla'
},
operation: 'cr',
type: 'reward',
status: 'success',
updated_at: '2023-05-18T06:37:57.506Z',
created_at: '2023-05-18T06:37:57.506Z'

Extra webhook data specific to review_create, review_update

You might receive more properties in the webhook data payload than listed below

entity_id: '449ebf4f-f3e2-471a-a21f-47d8e148f259',
lead_id: 'd9058911-9300-4f3f-b2a4-e35bc1896d02',
order_id: '',
activity_id: '',
reference_product_name: 'The Multi-location Snowboard',
reference_product_source: 'shopify',
reference_product_id: '8198530236709',
reference_product_redirect_link: 'https://nector-dev-store-99.myshopify.com/products/the-multi-location-snowboard',
reference_review_source: '',
reference_review_id: '',
type: 'review',
name: 'Testing it',
rating: 5,
title: 'Tester Bro',
description: 'Tester Bro',
reply_to: '',
meta: {
  coin_reward: 'Ayush Shukla',
  is_rewarded: ''
},
is_verified: '',
is_approved: true,
is_featured: '',
updated_at: '2023-05-26T07:46:19.936Z',
created_at: '2023-05-26T07:46:19.936Z'

Extra webhook data specific to order_create, order_update

You might receive more properties in the webhook data payload than listed below

entity_id: '449ebf4f-f3e2-471a-a21f-47d8e148f259',
lead_id: '8decb740-15ce-46e9-88c7-60455b8c9340',
reference_order_name: '#1028',
reference_order_id: '5372084388133',
reference_order_source: 'shopify',
activity_id: '',
currency_code: 'inr',
reference_cart_token: 'abae330db82ddbd690280a6bedaa0e71',
fiat_amount: 849.54,
fiat_discount: 10,
fiat_tax: 129.59,
payment_source: 'bogus',
payment_medium: 'direct',
utm_source: '',
utm_medium: '',
utm_campaign: '',
order_driven_by: 'nector_but_code',
couponredeem_driven_by: 'manual_slide',
status: 'pending',
financial_status: 'paid',
delivery_status: 'pending',
meta: {
  lead_name: 'Ayush Shukla',
  coin_spent: 100,
  coin_reward: 10,
  currency_code: 'inr',
  redirect_link: 'https://nector-dev-store-1.myshopify.com/74023928101/orders/6792fa1820a88c90c85fc12339ec7be0/authenticate?key=100a341ee60cf741d98714cca1e245ea&utm_source=nector&utm_medium=email&utm_campaign=transactional'
},
updated_at: '2023-05-26T07:49:06.277Z',
created_at: '2023-05-26T07:49:06.277Z'

Extra webhook data specific to reviewrequest_create

You might receive more properties in the webhook data payload than listed below

entity_id: '449ebf4f-f3e2-471a-a21f-47d8e148f259',
lead_id: '8decb740-15ce-46e9-88c7-60455b8c9340',
reference_order_name: '#1028',
reference_order_id: '5372084388133',
reference_order_source: 'shopify',
activity_id: '',
currency_code: 'inr',
reference_cart_token: 'abae330db82ddbd690280a6bedaa0e71',
fiat_amount: 849.54,
fiat_discount: 10,
fiat_tax: 129.59,
payment_source: 'bogus',
payment_medium: 'direct',
utm_source: '',
utm_medium: '',
utm_campaign: '',
order_driven_by: 'nector_but_code',
couponredeem_driven_by: 'manual_slide',
status: 'pending',
financial_status: 'paid',
delivery_status: 'pending',
meta: {
  lead_name: 'Ayush Shukla',
  coin_spent: 100,
  coin_reward: 10,
  currency_code: 'inr',
  redirect_link: 'https://nector-dev-store-1.myshopify.com/74023928101/orders/6792fa1820a88c90c85fc12339ec7be0/authenticate?key=100a341ee60cf741d98714cca1e245ea&utm_source=nector&utm_medium=email&utm_campaign=transactional'
},
order_review_link: "https://reviewcollect.nector.io?order_id=dbd690280a6",
updated_at: '2023-05-26T07:49:06.277Z',
created_at: '2023-05-26T07:49:06.277Z'

Extra webhook data specific to refereenotify_create, referrernotify_create, incompletereferralrequest_create

You might receive more properties in the webhook data payload than listed below

_id: "b08d3718-e8e8-48d5-a19a-e0af8ddeb6f4",
entity_id: "2c1aceb6-7ec7-4246-89d0-25775afcd649",
coupon_id: "",
wallettransaction_id: "",
order_id: "80072df7-544c-43cc-b375-c248ad2430e9",
referral_mode: "link",
referred_by_name: "Yashas",
referred_by_lead_id: "d273a765-3bfa-424e-bfd1-69ebccf69b2c",
referred_by_eid: "a6a47613b6c9db37330de53789926289aaad5d116b330806fb50bf05b0053907",
referred_by_mid: "ba68488520b137878f5a6925ea88b8c367dc27f52ed6c40d17dc8d1072cb0ec3",
referred_to_name: "yashas reddy",
referred_to_lead_id: "a309e29d-2260-43c7-be4c-f790cde4d62c",
referred_to_eid: "ca93d8b22152019b457d64c879171a59854e4b386864a59d9f9332f480a2ed1a",
referred_to_mid: "aa9b2c9dc1f56105a6f82e23fb6ebc0fb3f12f6457fd1bd3431d1dd6c080f287",
meta: {
    referred_by_coupon_id: null,
    referred_to_coupon_id: "d9bf0931-62e0-45ea-b38e-27143e38c574",
    incompletereferralrequest_count: 0,
    incompletereferralrequest_sentat: null,
    referred_by_wallettransaction_id: "471e6c4f-3c0c-43cb-b88e-39fa065f68de",
    referred_to_wallettransaction_id: null
},
status: "completed",
created_at: "2024-01-09T13:32:29.525Z",
updated_at: "2024-01-09T13:34:06.112Z",
version: 2,

// if the referrer reward is wallet coins, below properties will be present
wallettransaction_title: "Referral Reward",
wallettransaction_description: "",
wallettransaction_amount: 500,
wallettransaction_closing_balance: 31546,

// if the referrer reward is a coupon, below properties will be present
coupon_name: "₹200 Off coupon",
coupon_description: "No minimum cart amount required",
coupon_value: "necpri70l1p93uebufs",
coupon_fiat_value: 200,
coupon_fiat_target: "cart",
coupon_fiat_class: "amount",
coupon_minimumcart_amount: "",
coupon_formatted_expire: "January 24th 2024, 1:31:14 pm",
coupon_expire: "2024-01-24T13:31:14.545Z",
coupon_redirect_link: "https://nector-dev-store-2.myshopify.com/discount/necpri70l1p93uebufs?utm_source=nector&utm_medium=webhook&utm_campaign=transactional"

Extra webhook data specific to coinexpirynotify_create

You might receive more properties in the webhook data payload than listed below

wallet_expiry_unit: "month", // values: month, week, day
wallet_expiry_amount: 500,
wallet_expiry_notify_generated_on: "2023-04-26T11:23:07.692Z",
wallet_expiry_estimated_on: "2023-04-26T11:23:07.692Z",
wallet_expiry_formatted_estimated_on: "June 2nd 2023, 6:40:33 am"

Extra webhook data specific to viptier_create

You might receive more properties in the webhook data payload than listed below

"entity_id": "449ebf4f-f3e2-471a-a21f-47d8e148f259",
"lead_id": "8decb740-15ce-46e9-88c7-60455b8c9340",
"tier": "silver",
"direction": "up", // values: up, down (indicates whether tier was upgraded or downgraded)
"formatted_tier": "Silver",
"updated_at": "2023-05-26T07:49:06.277Z",
"created_at": "2023-05-26T07:49:06.277Z"

Updated on: 12/09/2024