Skip to content

armgit / dub

Public Imported from GitHub
0

The modern link attribution platform. Loved by world-class engineering teams at Twilio, Zillow, Jobber, Vercel, Raycast, and more.

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.ts
index 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 future
const sourcePartnerUser = sourcePartnerUsers[0];
diff --git a/apps/web/lib/integrations/slack/transform.ts b/apps/web/lib/integrations/slack/transform.ts
index 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.tsx
index 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.tsx
index 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.ts
index 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.json
new file mode 100644
index 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.ts
index 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.ts
index 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 = z
outputId: "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.ts
index 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.ts
index 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.ts
index 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,