dubinc · steven-tey · Sep 15, 2025 · Sep 8, 2025 · Sep 8, 2025 · Sep 8, 2025
diff --git a/apps/web/app/(ee)/api/cron/import/firstpromoter/route.ts b/apps/web/app/(ee)/api/cron/import/firstpromoter/route.ts
@@ -0,0 +1,48 @@
+import { handleAndReturnErrorResponse } from "@/lib/api/errors";
+import { verifyQstashSignature } from "@/lib/cron/verify-qstash";
+import { importCampaigns } from "@/lib/firstpromoter/import-campaigns";
+import { importCommissions } from "@/lib/firstpromoter/import-commissions";
+import { importCustomers } from "@/lib/firstpromoter/import-customers";
+import { importPartners } from "@/lib/firstpromoter/import-partners";
+import { firstPromoterImportPayloadSchema } from "@/lib/firstpromoter/schemas";
+import { updateStripeCustomers } from "@/lib/firstpromoter/update-stripe-customers";
+import { NextResponse } from "next/server";
+
+export const dynamic = "force-dynamic";
+
+export async function POST(req: Request) {
+  try {
+    const rawBody = await req.text();
+
+    await verifyQstashSignature({
+      req,
+      rawBody,
+    });
+
+    const payload = firstPromoterImportPayloadSchema.parse(JSON.parse(rawBody));
+
+    switch (payload.action) {
+      case "import-campaigns":
+        await importCampaigns(payload);
+        break;
+      case "import-partners":
+        await importPartners(payload);
+        break;
+      case "import-customers":
+        await importCustomers(payload);
+        break;
+      case "import-commissions":
+        await importCommissions(payload);
+        break;
+      case "update-stripe-customers":
+        await updateStripeCustomers(payload);
+        break;
+      default:
+        throw new Error(`Unknown action: ${payload.action}`);
+    }
+
+    return NextResponse.json("OK");
+  } catch (error) {
+    return handleAndReturnErrorResponse(error);
+  }
+}
diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/partners/import-export-buttons.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/partners/import-export-buttons.tsx
@@ -3,6 +3,7 @@
 import { PROGRAM_IMPORT_SOURCES } from "@/lib/partners/constants";
 import useWorkspace from "@/lib/swr/use-workspace";
 import { useExportPartnersModal } from "@/ui/modals/export-partners-modal";
+import { useImportFirstPromoterModal } from "@/ui/modals/import-firstpromoter-modal";
 import { useImportPartnerStackModal } from "@/ui/modals/import-partnerstack-modal";
 import { useImportRewardfulModal } from "@/ui/modals/import-rewardful-modal";
 import { useImportToltModal } from "@/ui/modals/import-tolt-modal";
@@ -19,6 +20,7 @@ export function ImportExportButtons() {
   const { ImportToltModal } = useImportToltModal();
   const { ImportRewardfulModal } = useImportRewardfulModal();
   const { ImportPartnerStackModal } = useImportPartnerStackModal();
+  const { ImportFirstPromoterModal } = useImportFirstPromoterModal();
 
   const { ExportPartnersModal, setShowExportPartnersModal } =
     useExportPartnersModal();
@@ -27,6 +29,7 @@ export function ImportExportButtons() {
     <>
       <ImportToltModal />
       <ImportRewardfulModal />
+      <ImportFirstPromoterModal />
       <ImportPartnerStackModal />
       <ExportPartnersModal />
       <Popover

diff --git a/apps/web/lib/actions/partners/start-firstpromoter-import.ts b/apps/web/lib/actions/partners/start-firstpromoter-import.ts
@@ -0,0 +1,60 @@
+"use server";
+
+import { createId } from "@/lib/api/create-id";
+import { getDefaultProgramIdOrThrow } from "@/lib/api/programs/get-default-program-id-or-throw";
+import { getProgramOrThrow } from "@/lib/api/programs/get-program-or-throw";
+import { FirstPromoterApi } from "@/lib/firstpromoter/api";
+import { firstPromoterImporter } from "@/lib/firstpromoter/importer";
+import { firstPromoterCredentialsSchema } from "@/lib/firstpromoter/schemas";
+import { z } from "zod";
+import { authActionClient } from "../safe-action";
+
+const schema = firstPromoterCredentialsSchema.extend({
+  workspaceId: z.string(),
+});
+
+export const startFirstPromoterImportAction = authActionClient
+  .schema(schema)
+  .action(async ({ ctx, parsedInput }) => {
+    const { workspace, user } = ctx;
+    const { apiKey, accountId } = parsedInput;
+
+    const programId = getDefaultProgramIdOrThrow(workspace);
+
+    const program = await getProgramOrThrow({
+      workspaceId: workspace.id,
+      programId,
+    });
+
+    if (!program.domain) {
+      throw new Error("Program domain is not set.");
+    }
+
+    if (!program.url) {
+      throw new Error("Program URL is not set.");
+    }
+
+    const firstPromoterApi = new FirstPromoterApi({ apiKey, accountId });
+
+    try {
+      await firstPromoterApi.testConnection();
+    } catch (error) {
+      throw new Error(
+        error instanceof Error
+          ? error.message
+          : "Invalid FirstPromoter credentials.",
+      );
+    }
+
+    await firstPromoterImporter.setCredentials(workspace.id, {
+      apiKey,
+      accountId,
+    });
+
+    await firstPromoterImporter.queue({
+      importId: createId({ prefix: "import_" }),
+      action: "import-campaigns",
+      userId: user.id,
+      programId,
+    });
+  });
diff --git a/apps/web/lib/firstpromoter/api.ts b/apps/web/lib/firstpromoter/api.ts
@@ -0,0 +1,107 @@
+import { z } from "zod";
+import { PAGE_LIMIT } from "./importer";
+import {
+  firstPromoterCampaignSchema,
+  firstPromoterCommissionSchema,
+  firstPromoterCustomerSchema,
+  firstPromoterPartnerSchema,
+} from "./schemas";
+
+export class FirstPromoterApi {
+  private readonly baseUrl = "https://v2.firstpromoter.com/api/v2/company";
+  private readonly apiKey: string;
+  private readonly accountId: string;
+
+  constructor({ apiKey, accountId }: { apiKey: string; accountId: string }) {
+    this.apiKey = apiKey;
+    this.accountId = accountId;
+  }
+
+  private async fetch<T>(path: string): Promise<T> {
+    const response = await fetch(`${this.baseUrl}${path}`, {
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        "ACCOUNT-ID": this.accountId,
+      },
+    });
+
+    if (!response.ok) {
+      const error = await response.json();
+
+      console.error("FirstPromoter API Error:", error);
+      throw new Error(error.message || "Unknown error from FirstPromoter API.");
+    }
+
+    return await response.json();
+  }
+
+  async testConnection() {
+    try {
+      await this.fetch("/promoter_campaigns?page=1&per_page=1");
+      return true;
+    } catch (error) {
+      throw new Error("Invalid FirstPromoter API token.");
+    }
+  }
+
+  async listCampaigns({ page }: { page?: number }) {
+    const searchParams = new URLSearchParams({
+      per_page: PAGE_LIMIT.toString(),
+      ...(page ? { page: page.toString() } : {}),
+    });
+
+    const campaigns = await this.fetch(
+      `/promoter_campaigns?${searchParams.toString()}`,
+    );
+
+    return firstPromoterCampaignSchema.array().parse(campaigns);
+  }
+
+  async listPartners({ page }: { page?: number }) {
+    const searchParams = new URLSearchParams({
+      filters: JSON.stringify({
+        archived: false,
+        state: "accepted",
+        referrals_count: {
+          from: 1,
+        },
+      }),
+      per_page: PAGE_LIMIT.toString(),
+      ...(page ? { page: page.toString() } : {}),
+    });
+
+    const response = await this.fetch(`/promoters?${searchParams.toString()}`);
+
+    const { data: partners } = z
+      .object({
+        data: firstPromoterPartnerSchema.array(),
+      })
+      .parse(response);
+
+    return partners;
+  }
+
+  async listCustomers({ page }: { page?: number }) {
+    const searchParams = new URLSearchParams({
+      per_page: PAGE_LIMIT.toString(),
+      ...(page ? { page: page.toString() } : {}),
+    });
+
+    const customers = await this.fetch(`/referrals?${searchParams.toString()}`);
+
+    return firstPromoterCustomerSchema.array().parse(customers);
+  }
+
+  async listCommissions({ page }: { page?: number }) {
+    const searchParams = new URLSearchParams({
+      per_page: PAGE_LIMIT.toString(),
+      ...(page ? { page: page.toString() } : {}),
+    });
+
+    const commissions = await this.fetch(
+      `/commissions?${searchParams.toString()}`,
+    );
+
+    return firstPromoterCommissionSchema.array().parse(commissions);
+  }
+}
diff --git a/apps/web/lib/firstpromoter/import-campaigns.ts b/apps/web/lib/firstpromoter/import-campaigns.ts
@@ -0,0 +1,74 @@
+import { RESOURCE_COLORS } from "@/ui/colors";
+import { prisma } from "@dub/prisma";
+import { randomValue } from "@dub/utils";
+import slugify from "@sindresorhus/slugify";
+import { createId } from "../api/create-id";
+import { FirstPromoterApi } from "./api";
+import { firstPromoterImporter, MAX_BATCHES } from "./importer";
+import { FirstPromoterImportPayload } from "./types";
+
+export async function importCampaigns(payload: FirstPromoterImportPayload) {
+  const { programId, page = 1 } = payload;
+
+  // Find the program and their groups
+  const program = await prisma.program.findUniqueOrThrow({
+    where: {
+      id: programId,
+    },
+    include: {
+      groups: true,
+    },
+  });
+
+  // Groups in the program
+  const existingGroupNames = program.groups.map((group) => group.name);
+
+  const credentials = await firstPromoterImporter.getCredentials(
+    program.workspaceId,
+  );
+
+  const firstPromoterApi = new FirstPromoterApi(credentials);
+
+  let hasMore = true;
+  let processedBatches = 0;
+  let currentPage = page;
+
+  while (processedBatches < MAX_BATCHES) {
+    const campaigns = await firstPromoterApi.listCampaigns({
+      page: currentPage,
+    });
+
+    if (campaigns.length === 0) {
+      hasMore = false;
+      break;
+    }
+
+    // Find the campaigns that don't exist in the program
+    // We compare the group name with the campaign name
+    const newCampaigns = campaigns.filter(
+      (campaign) => !existingGroupNames.includes(campaign.campaign.name),
+    );
+
+    if (newCampaigns.length > 0) {
+      const groups = await prisma.partnerGroup.createMany({
+        data: newCampaigns.map((campaign) => ({
+          id: createId({ prefix: "grp_" }),
+          programId: program.id,
+          slug: slugify(campaign.campaign.name),
+          name: campaign.campaign.name,
+          color: randomValue(RESOURCE_COLORS),
+        })),
+        skipDuplicates: true,
+      });
+    }
+
+    currentPage++;
+    processedBatches++;
+  }
+
+  await firstPromoterImporter.queue({
+    ...payload,
+    action: hasMore ? "import-campaigns" : "import-partners",
+    page: hasMore ? currentPage : undefined,
+  });
+}