API Integrations

Vercel Marketplace

Connect Nitrosend to Vercel projects and understand resource setup and Marketplace billing
Info

The integration is currently unlisted. Open its direct integration page; Marketplace billing is available only when Vercel shows a product and plan quote. Otherwise, use the regular Nitrosend dashboard and API key flow.

Nitrosend's Vercel Marketplace integration is a thin native adapter over the existing Nitrosend dashboard. Vercel handles install, resource connection, secret delivery, plan changes, and billing. Nitrosend handles account, brand, campaign, list, template, and support workflows in the existing dashboard through SSO.

The Marketplace integration is provider-isolated: an existing Nitrosend login may be reused for SSO, but a Vercel installation is not silently attached to a Stripe-owned account. Vercel's installation and resource identifiers remain the source of ownership for its local entitlement.

What Vercel Creates

When you install Nitrosend from Vercel Marketplace, Vercel provisions a nitrosend-email resource. The resource maps to a Nitrosend account and brand, then creates project secrets for connected Vercel projects:

  • NITROSEND_API_KEY
  • NITROSEND_MCP_URL
  • NITROSEND_API_URL

Vercel may add a project-selected prefix when a resource is connected to a project. If you choose a prefix in Vercel, use the prefixed variable names in your app. Without a prefix, the examples below work as written.

Use With AI SDK

npm install @nitrosend/ai-sdk ai @ai-sdk/mcp zod
import { generateText, isStepCount } from "ai";
import { withNitrosendTools } from "@nitrosend/ai-sdk";

const result = await withNitrosendTools({}, async ({ tools }) => {
  return generateText({
    model,
    tools,
    stopWhen: isStepCount(5),
    prompt: "Draft a welcome campaign for the newest trial users.",
  });
});

@nitrosend/ai-sdk reads NITROSEND_API_KEY and NITROSEND_MCP_URL automatically from the Vercel project environment.

Management

Use Vercel for Marketplace resource operations:

  • install and reinstall Nitrosend
  • connect the resource to projects
  • rotate secrets, with old keys kept through Vercel's requested grace window
  • change the Marketplace billing plan
  • uninstall the resource

Use the existing Nitrosend dashboard for product work:

  • manage brands and sending domains
  • build campaigns and templates
  • manage lists and contacts
  • review usage and account settings
  • contact support

There is no separate Marketplace dashboard. Vercel SSO opens the existing Nitrosend dashboard with the right account and brand context.

The SSO entry point follows Vercel's redirect-login flow: Vercel sends mode=sso, code, and state; Nitrosend exchanges them with Vercel for a short-lived OIDC token, verifies it, then opens the existing dashboard callback.

If the email on your Vercel team already has a Nitrosend account, the install is not attached to it automatically. Vercel shows a notice, and the first SSO takes you to the Nitrosend sign-in; once you are signed in as an admin of the account you want to use, the installation is linked to it. Installs with a new email get a Nitrosend account created for them.

Billing

Marketplace-billed resources are billed through Vercel. Nitrosend keeps a local entitlement subscription so account limits work, but it does not create a separate direct subscription for the same Marketplace resource.

The current Marketplace catalog uses monthly offers for Free, Starter, Pro, Growth and Scale. The quote shown by Vercel determines the price and available interval; annual website prices are not a promise of annual Vercel billing. Existing resource prices and provider plan references stay intact until you explicitly choose another offer. Do not create a second direct subscription to change a Vercel-owned account.

Paid Marketplace plans use resource-level billing, usage reporting, invoice submission, and invoice lifecycle webhooks. Free resources do not submit chargeable invoices.

Nitrosend sends Vercel's current Marketplace billing payloads: usage reports go to /billing with timestamp, eod, period, billing.items, and usage; invoices go to /billing/invoices with invoiceDate, period, items, and a stable externalId. Invoice webhooks are verified with Vercel's X-Vercel-Signature header before entitlement state is updated. Failed-payment notpaid events are recorded without immediate suspension; overdue or refunded events suspend the Marketplace resource, and paid events reactivate it. Paid resource and installation deletions submit a final resource invoice before deactivating local entitlements, and deletion responses remain unfinalized while Marketplace invoices are open.