The modern link attribution platform. Loved by world-class engineering teams at Twilio, Zillow, Jobber, Vercel, Raycast, and more.
TypeScript clickhousemysqlnextjsopen-sourceplanetscaleprismatailwindcsstinybirdtypescriptupstashvercel
partner.merged webhook for account merges
Pedro Ladeirad6e4d2dc71e1
diff --git a/apps/web/app/(ee)/api/cron/partners/merge-accounts/route.ts b/apps/web/app/(ee)/api/cron/partners/merge-accounts/route.tsindex f0d85d0916..b326730fde 100644--- a/apps/web/app/(ee)/api/cron/partners/merge-accounts/route.ts+++ b/apps/web/app/(ee)/api/cron/partners/merge-accounts/route.ts@@ -11,6 +11,8 @@ import { prisma } from "@/lib/prisma";import { storage } from "@/lib/storage";import { recordLink } from "@/lib/tinybird";import { redis } from "@/lib/upstash";+import { sendWorkspaceWebhook } from "@/lib/webhook/publish";+import { partnerMergedWebhookSchema } from "@/lib/zod/schemas/partners";import { sendBatchEmail } from "@dub/email";import PartnerAccountMerged from "@dub/email/templates/partner-account-merged";import { log, prettyPrint, R2_URL } from "@dub/utils";@@ -69,6 +71,16 @@ export async function POST(req: Request) {programId: true,tenantId: true,status: true,+ program: {+ select: {+ workspace: {+ select: {+ id: true,+ webhookEnabled: true,+ },+ },+ },+ },},},users: {@@ -323,6 +335,37 @@ export async function POST(req: Request) {}}+ if (sourcePartnerEnrollments.length > 0) {+ const webhookResults = await Promise.allSettled(+ sourcePartnerEnrollments.map((sourceEnrollment) => {+ const targetEnrollment = targetPartnerEnrollments.find(+ ({ programId }) => programId === sourceEnrollment.programId,+ );++ return sendWorkspaceWebhook({+ workspace: sourceEnrollment.program.workspace,+ trigger: "partner.merged",+ data: partnerMergedWebhookSchema.parse({+ programId: sourceEnrollment.programId,+ targetAlreadyEnrolled: Boolean(targetEnrollment),+ source: {+ id: sourcePartnerId,+ tenantId: sourceEnrollment.tenantId,+ email: sourceAccount.email ?? null,+ },+ target: {+ id: targetPartnerId,+ tenantId:+ targetEnrollment?.tenantId ?? sourceEnrollment.tenantId,+ email: targetAccount.email ?? null,+ },+ }),+ });+ }),+ );+ console.log(prettyPrint(webhookResults));+ }+// Remove the user if there are no workspaces left// TODO: we need to handle deleting multiple users when we allow partners to invite their team members in the futureconst sourcePartnerUser = sourcePartnerUsers[0];diff --git a/apps/web/lib/integrations/slack/transform.ts b/apps/web/lib/integrations/slack/transform.tsindex f3288b5255..9381a34437 100644--- a/apps/web/lib/integrations/slack/transform.ts+++ b/apps/web/lib/integrations/slack/transform.ts@@ -13,6 +13,7 @@ import {LeadEventWebhookPayload,PartnerApplicationWebhookPayload,PartnerEventWebhookPayload,+ PartnerMergedWebhookPayload,PayoutEventWebhookPayload,SaleEventWebhookPayload,} from "../../webhook/types";@@ -535,6 +536,69 @@ const bountyTemplates = ({};};+const partnerMergedTemplate = ({+ data,+}: {+ data: PartnerMergedWebhookPayload;+}) => {+ const { targetAlreadyEnrolled, source, target } = data;+ const hrefToPartnerPage = `${APP_DOMAIN}/program/partners/${target.id}`;+ const outcomeLabel = targetAlreadyEnrolled+ ? "Target was already enrolled"+ : "Target was not enrolled";++ return {+ blocks: [+ {+ type: "section",+ text: {+ type: "mrkdwn",+ text: `*Partner accounts merged* :twisted_rightwards_arrows:`,+ },+ },+ {+ type: "section",+ fields: [+ {+ type: "mrkdwn",+ text: `*Source*\n\`${source.id}\`${source.email ? ` (${source.email})` : ""}`,+ },+ {+ type: "mrkdwn",+ text: `*Target*\n<${hrefToPartnerPage}|\`${target.id}\`>${target.email ? ` (${target.email})` : ""}`,+ },+ ],+ },+ {+ type: "section",+ fields: [+ {+ type: "mrkdwn",+ text: `*Outcome*\n${outcomeLabel}`,+ },+ ...(source.tenantId || target.tenantId+ ? [+ {+ type: "mrkdwn",+ text: `*Tenant ID*\n${source.tenantId ?? "—"} → ${target.tenantId ?? "—"}`,+ },+ ]+ : []),+ ],+ },+ {+ type: "context",+ elements: [+ {+ type: "mrkdwn",+ text: `<${hrefToPartnerPage}|View on Dub>`,+ },+ ],+ },+ ],+ };+};+const payoutConfirmedTemplate = ({data,}: {@@ -604,6 +668,7 @@ const slackTemplates: Record<WebhookTrigger, any> = {"lead.created": leadCreatedTemplate,"sale.created": saleCreatedTemplate,"partner.enrolled": partnerEnrolledTemplate,+ "partner.merged": partnerMergedTemplate,"partner.application_submitted": partnerApplicationSubmittedTemplate,"commission.created": commissionCreatedTemplate,"bounty.created": bountyTemplates,diff --git a/apps/web/lib/integrations/slack/ui/settings.tsx b/apps/web/lib/integrations/slack/ui/settings.tsxindex b62f88cb8f..b57b963440 100644--- a/apps/web/lib/integrations/slack/ui/settings.tsx+++ b/apps/web/lib/integrations/slack/ui/settings.tsx@@ -19,6 +19,7 @@ export const SlackSettings = (props: InstalledIntegrationInfoProps) => {"lead.created","sale.created","partner.enrolled",+ "partner.merged","commission.created","bounty.created","bounty.updated",diff --git a/apps/web/lib/integrations/zapier/ui/settings.tsx b/apps/web/lib/integrations/zapier/ui/settings.tsxindex 6f5c9f874c..a3e2859dc5 100644--- a/apps/web/lib/integrations/zapier/ui/settings.tsx+++ b/apps/web/lib/integrations/zapier/ui/settings.tsx@@ -20,6 +20,7 @@ export const ZapierSettings = (props: InstalledIntegrationInfoProps) => {"sale.created","partner.application_submitted","partner.enrolled",+ "partner.merged",]}/>)}diff --git a/apps/web/lib/webhook/constants.ts b/apps/web/lib/webhook/constants.tsindex 4040bbf31a..ee783814e1 100644--- a/apps/web/lib/webhook/constants.ts+++ b/apps/web/lib/webhook/constants.ts@@ -22,6 +22,7 @@ export const WORKSPACE_LEVEL_WEBHOOK_TRIGGERS = [export const PROGRAM_LEVEL_WEBHOOK_TRIGGERS = ["partner.application_submitted","partner.enrolled",+ "partner.merged","commission.created","bounty.created","bounty.updated",@@ -42,6 +43,7 @@ export const WEBHOOK_TRIGGER_DESCRIPTIONS: Record<WebhookTrigger, string> = {"sale.created": "Sale created","partner.application_submitted": "Partner application submitted","partner.enrolled": "Partner enrolled",+ "partner.merged": "Partner accounts merged","commission.created": "Commission created","bounty.created": "Bounty created","bounty.updated": "Bounty updated",diff --git a/apps/web/lib/webhook/sample-events/partner-merged.json b/apps/web/lib/webhook/sample-events/partner-merged.jsonnew file mode 100644index 0000000000..d9e3d8e722--- /dev/null+++ b/apps/web/lib/webhook/sample-events/partner-merged.json@@ -0,0 +1,14 @@+{+ "programId": "prog_CYCu7IMAapjkRpTnr8F1azjN",+ "targetAlreadyEnrolled": false,+ "source": {+ "id": "pn_1K9BZE1K285BSTX4W6MPKXJFZ",+ "tenantId": "64dc9a8c-5cf9-4446-b53b-cdc15199fafc",+ "email": "[email protected]"+ },+ "target": {+ "id": "pn_1K06X6FX2GRB31NCM2VVCGJ72",+ "tenantId": "64dc9a8c-5cf9-4446-b53b-cdc15199fafc",+ "email": "[email protected]"+ }+}diff --git a/apps/web/lib/webhook/sample-events/payload.ts b/apps/web/lib/webhook/sample-events/payload.tsindex 546af93656..25073fcf76 100644--- a/apps/web/lib/webhook/sample-events/payload.ts+++ b/apps/web/lib/webhook/sample-events/payload.ts@@ -9,6 +9,7 @@ import linkDeleted from "./link-deleted.json";import linkUpdated from "./link-updated.json";import partnerApplicationSubmitted from "./partner-application-submitted.json";import partnerEnrolled from "./partner-enrolled.json";+import partnerMerged from "./partner-merged.json";import payoutConfirmed from "./payout-confirmed.json";import saleCreated from "./sale-created.json";@@ -21,6 +22,7 @@ export const samplePayload: Record<WebhookTrigger, any> = {"sale.created": saleCreated,"partner.application_submitted": partnerApplicationSubmitted,"partner.enrolled": partnerEnrolled,+ "partner.merged": partnerMerged,"commission.created": commissionCreated,"bounty.created": bountyCreated,"bounty.updated": bountyUpdated,diff --git a/apps/web/lib/webhook/schemas.ts b/apps/web/lib/webhook/schemas.tsindex c67e5c8efc..c6b3dac3d9 100644--- a/apps/web/lib/webhook/schemas.ts+++ b/apps/web/lib/webhook/schemas.ts@@ -5,6 +5,7 @@ import { CustomerSchema } from "../zod/schemas/customers";import { linkEventSchema } from "../zod/schemas/links";import {EnrolledPartnerSchema,+ partnerMergedWebhookSchema,WebhookPartnerSchema,} from "../zod/schemas/partners";import { partnerApplicationWebhookSchema } from "../zod/schemas/program-application";@@ -156,6 +157,20 @@ export const webhookEventSchema = zoutputId: "PartnerApplicationSubmittedEvent",}),+ z+ .object({+ id: z.string(),+ event: z.literal("partner.merged"),+ createdAt: z.string(),+ data: partnerMergedWebhookSchema,+ })+ .meta({+ description:+ "Triggered when two partner accounts are merged. Fired once per program the source partner was enrolled in.",+ id: "PartnerMergedEvent",+ outputId: "PartnerMergedEvent",+ }),+z.object({id: z.string(),diff --git a/apps/web/lib/webhook/types.ts b/apps/web/lib/webhook/types.tsindex b25707c8a0..58a7fcc832 100644--- a/apps/web/lib/webhook/types.ts+++ b/apps/web/lib/webhook/types.ts@@ -2,7 +2,10 @@ import * as z from "zod/v4";import { BountySchema } from "../zod/schemas/bounties";import { CommissionWebhookSchema } from "../zod/schemas/commissions";import { linkEventSchema } from "../zod/schemas/links";-import { EnrolledPartnerSchema } from "../zod/schemas/partners";+import {+ EnrolledPartnerSchema,+ partnerMergedWebhookSchema,+} from "../zod/schemas/partners";import { payoutWebhookEventSchema } from "../zod/schemas/payouts";import { partnerApplicationWebhookSchema } from "../zod/schemas/program-application";import { WEBHOOK_TRIGGERS } from "./constants";@@ -26,6 +29,10 @@ export type PartnerApplicationWebhookPayload = z.infer<typeof partnerApplicationWebhookSchema>;+export type PartnerMergedWebhookPayload = z.infer<+ typeof partnerMergedWebhookSchema+>;+export type CommissionEventWebhookPayload = z.infer<typeof CommissionWebhookSchema>;@@ -43,6 +50,7 @@ export type WebhookEventPayload =| SaleEventWebhookPayload| PartnerEventWebhookPayload| PartnerApplicationWebhookPayload+ | PartnerMergedWebhookPayload| CommissionEventWebhookPayload| BountyEventWebhookPayload| PayoutEventWebhookPayload;diff --git a/apps/web/lib/zod/schemas/partners.ts b/apps/web/lib/zod/schemas/partners.tsindex 9096fc1453..f114323c30 100644--- a/apps/web/lib/zod/schemas/partners.ts+++ b/apps/web/lib/zod/schemas/partners.ts@@ -629,6 +629,30 @@ export const WebhookPartnerSchema = PartnerSchema.pick({totalCommissions: centsSchema,});+const partnerMergedAccountSchema = z.object({+ id: z.string().describe("The partner's unique ID on Dub."),+ tenantId: z+ .string()+ .nullable()+ .describe("The partner's unique ID within your database for this program."),+ email: z.string().nullable().describe("The partner's email address."),+});++export const partnerMergedWebhookSchema = z.object({+ programId: z.string().describe("The program's unique ID on Dub."),+ targetAlreadyEnrolled: z+ .boolean()+ .describe(+ "Whether the surviving partner was already enrolled in this program before the merge. If `true`, the workspace had both partners and should collapse the source into the target. If `false`, only the source was enrolled and its Dub partner ID changed.",+ ),+ source: partnerMergedAccountSchema.describe(+ "The partner account that was merged away. Its ID no longer exists.",+ ),+ target: partnerMergedAccountSchema.describe(+ "The surviving partner account. `tenantId` is the post-merge value for this program.",+ ),+});+export const LeaderboardPartnerSchema = z.object({id: z.string(),totalCommissions: centsSchemaWithDefault,diff --git a/apps/web/tests/webhooks/index.test.ts b/apps/web/tests/webhooks/index.test.tsindex 863522a25f..34dbdc8a91 100644--- a/apps/web/tests/webhooks/index.test.ts+++ b/apps/web/tests/webhooks/index.test.ts@@ -12,7 +12,10 @@ import { BountySchema } from "@/lib/zod/schemas/bounties";import { CommissionWebhookSchema } from "@/lib/zod/schemas/commissions";import { CustomerSchema } from "@/lib/zod/schemas/customers";import { linkEventSchema } from "@/lib/zod/schemas/links";-import { EnrolledPartnerSchema } from "@/lib/zod/schemas/partners";+import {+ EnrolledPartnerSchema,+ partnerMergedWebhookSchema,+} from "@/lib/zod/schemas/partners";import { payoutWebhookEventSchema } from "@/lib/zod/schemas/payouts";import { partnerApplicationWebhookSchema } from "@/lib/zod/schemas/program-application";import { describe, expect, test } from "vitest";@@ -95,6 +98,7 @@ const eventSchemas: Record<WebhookTrigger, z.ZodSchema> = {"sale.created": saleWebhookEventSchemaExtended,"partner.application_submitted": partnerApplicationWebhookSchema,"partner.enrolled": enrolledPartnerSchemaExtended,+ "partner.merged": partnerMergedWebhookSchema,"commission.created": commissionWebhookEventSchemaExtended,"bounty.created": bountyWebhookEventSchemaExtended,"bounty.updated": bountyWebhookEventSchemaExtended,