This article assumes you have read and enabled the webhooks, please refer this article for more info: https://intercom.help/nector/en/articles/8547534-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
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 notify nudge is being sent to referee by referer - refereenotify_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_gender: "user's gender (string)",
user_country: "user's country (string)",
user_transaction_amount: "total order amount (number)",
user_transaction_count: "total order count(number)",
user_discount_amount: "total discount amount (number)",
user_discount_count: "total discount count (number)",
user_aov: "user's average order value (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: '',
transaction_count: '',
discount_amount: '',
discount_count: '',
last_transaction: '',
accept_email: true,
accept_mobile: true,
accept_smartdiscountapply: '',
aov: '',
dob: '',
full_dob: '',
gender: '',
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, incompletereferralrequest_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',
referred_by_name: 'Ayush',
referred_to_name: 'Yashas',
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 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"