# Vercel Marketplace {#vercel-marketplace}




> [!IMPORTANT]
> The integration is currently unlisted. Open its [direct integration page](https://vercel.com/integrations/nitrosend); 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 {#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 {#use-with-ai-sdk}


```bash
npm install @nitrosend/ai-sdk ai @ai-sdk/mcp zod
```

```ts
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 {#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 {#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.
