Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions fern/advanced/sip/sip.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,9 @@ Use the API base URL, private key, and SIP host from the same Vapi region. Do no
| United States | `dashboard.vapi.ai` | `https://api.vapi.ai` | `sip.vapi.ai` |
| European Union | `dashboard.eu.vapi.ai` | `https://api.eu.vapi.ai` | `sip.eu.vapi.ai` |

<Warning>
Vapi's EU support and self-serve growth are frozen until 2027. Existing EU customers can continue using their accounts, but Vapi is not offering new add-ons and does not guarantee feature parity with the US region. New self-serve customers should [create an account in the US region](https://dashboard.vapi.ai/register). If you require Vapi-hosted EU data residency, [contact Sales](https://vapi.ai/sales) about selective enterprise onboarding.
</Warning>
<Note>
Vapi offers an EU region with EU dashboard, API, and SIP endpoints. For more information, see [EU region and data residency](/security-and-privacy/eu-region).
</Note>

For existing EU organizations, create the SIP phone number against the EU API with an EU dashboard private key:

Expand Down
4 changes: 1 addition & 3 deletions fern/assistants/call-recording.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -549,9 +549,7 @@ Use artifact data for comprehensive insights:
</Accordion>

<Accordion title="How long are artifacts stored?">
Retention periods vary by plan:
- **Pay-As-You-Go:** Up to 30 days for chats and 14 days for calls
- **Enterprise:** Configurable retention policies
Retention periods vary by your plan. See [Pricing and Success Packages](/billing/pricing-and-success-packages#whats-included) for what each plan includes. To check your current plan, open **Billing & Payment** in the [Vapi Dashboard](https://dashboard.vapi.ai).
</Accordion>

<Accordion title="How do artifacts work with squad transfers?">
Expand Down
2 changes: 1 addition & 1 deletion fern/assistants/examples/inbound-support.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -983,5 +983,5 @@ Consider the reading the following guides to further enhance your assistant:
* [**Squads**](/squads) - Learn how to compose multiple assistants and transfer seamlessly for complex use cases.

<Callout>
Need help? Chat with the team on our [Discord](https://discord.com/invite/pUFNcf2WmH) or mention us on [X/Twitter](https://x.com/Vapi_AI).
Need help? Ask other developers in the [Vapi Discord community](https://discord.gg/v5Ee6FhAZt) or mention us on [X/Twitter](https://x.com/Vapi_AI).
</Callout>
2 changes: 1 addition & 1 deletion fern/assistants/examples/multilingual-agent.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -1050,5 +1050,5 @@ Consider reading the following guides to further enhance your multilingual imple
* [**Function tools**](/tools/custom-tools) - Build advanced multilingual tools and integrations

<Callout>
Need help with multilingual implementation? Chat with the team on our [Discord](https://discord.com/invite/pUFNcf2WmH) or mention us on [X/Twitter](https://x.com/Vapi_AI).
Need help with multilingual implementation? Ask other developers in the [Vapi Discord community](https://discord.gg/v5Ee6FhAZt) or mention us on [X/Twitter](https://x.com/Vapi_AI).
</Callout>
2 changes: 1 addition & 1 deletion fern/assistants/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -158,7 +158,7 @@ By default, when you create an assistant, the transcriber, model, and voice are
<Step title="Create the phone number">
Enter a three-digit US area code in **Area Code**, then select **Create**.

Your first free Vapi number does not require a payment method. To create additional free Vapi numbers, add a payment method. You can create up to five free Vapi numbers in total.
Your free Vapi number does not require a payment method. You get one free Vapi number, and your Success Package may include more.

<Warning>
Free Vapi phone numbers support US area codes only. For international use, import a number from another provider.
Expand Down
6 changes: 3 additions & 3 deletions fern/assistants/structured-outputs-quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -927,7 +927,7 @@ Common validation patterns for reliable extraction:

## Get help

Need assistance? We're here to help:
Need assistance? Try these resources:
- [API Documentation](/api-reference)
- [Discord Community](https://discord.gg/pUFNcf2WmH)
- [Support](mailto:support@vapi.ai)
- [Discord Community](https://discord.gg/v5Ee6FhAZt)
- [Support](/support)
119 changes: 76 additions & 43 deletions fern/billing/manage-billing-and-credits.mdx
Original file line number Diff line number Diff line change
@@ -1,74 +1,107 @@
---
title: "Manage pay-as-you-go billing and credits"
subtitle: "Add a payment method, buy credits, configure auto reload, and download billing records"
description: "Manage pay-as-you-go billing in the Vapi Dashboard: add a payment method, buy credits, configure auto reload, and download PDF statements and invoices. See Vapi pricing for rates."
title: Manage billing and credits
subtitle: Add a payment method, buy credits, set up auto-reload, and download billing records
description: "Manage billing in the Vapi Dashboard: add a payment method, buy Vapi credits, configure auto-reload, and download statements and invoices."
slug: billing/manage-billing-and-credits
---

This guide shows you how to set up billing for a pay-as-you-go subscription. By the end, you can fund the subscription and configure automatic credit purchases.
<Note>
If your Dashboard shows **Settings → Billing & Add-Ons** instead of **Billing & Payment**, see [Manage pay-as-you-go billing and credits](/billing/manage-pay-as-you-go-billing).
</Note>

Vapi credits are prepaid funds in US dollars that cover usage-based charges. This guide shows you how to add a payment method, fund your usage, keep your balance funded automatically, and download billing records.

## Prerequisites

- An **Admin** role in the organization.

## Steps
## How credits work

<Steps>
<Step title="Open the Billing page">
Sign in to the [Vapi Dashboard](https://dashboard.vapi.ai), select the organization you want to fund, open **Settings**, then select **Billing & Add-Ons**.
Credits cover usage-based costs:

<Frame>
<img src="../static/images/billing/billing-navigation.jpg" alt="Billing & Add-Ons selected in the Dashboard Settings navigation" />
</Frame>
</Step>
- The per-minute Vapi hosting fee draws down your balance as calls run.
- Model, voice, transcriber, and telephony costs also draw down your balance.

The Dashboard shows how Success Package and add-on fees are charged before you confirm a purchase. If your credit balance reaches $0 and auto-reload is off, Vapi freezes the subscription. You cannot start new calls or other billable usage until you purchase more credits.

<Step title="Add a payment method">
In **Payment method**, enter the billing email and card details. Select the checkmark beside each field to save it.
## Add or update a payment method

To replace a saved card, select the pencil beside **Payment method**, enter the new card details, then select the checkmark.
Your default card is used for credit purchases, auto-reload, and any recurring charges shown in the Dashboard. Add a card before you buy credits or turn on auto-reload.

<Frame caption="Billing email blurred for privacy.">
<img src="../static/images/billing/billing-payment-method.jpg" alt="Full Payment method block with the billing email blurred, card field, and auto reload controls" />
</Frame>
<Steps>
<Step title="Open the Billing page">
Sign in to the [Vapi Dashboard](https://dashboard.vapi.ai), make sure the [correct organization](/billing/manage-organizations-and-capacity#switch-organizations) is selected, and open **Billing**.
</Step>
<Step title="Manage payment methods">
Select **Manage payment** to open your saved cards. Add a new card, or select an existing card to set it as the default.
</Step>
<Step title="Save the card">
Enter the card details and confirm.
</Step>
</Steps>

<Step title="Buy credits">
At the top of the Billing page, select **Buy credits**. In **Purchase Vapi credits**, enter at least `$10` in **Amount to purchase**, then select **Purchase**.
## Buy credits

Complete any verification requested by the card issuer. A successful purchase increases the credit balance and appears as **Finalized** in **Credit purchase history**.
Buy credits to fund your organization's usage. Credits are added to the organization you have selected, so confirm you are on the [right organization](/billing/manage-organizations-and-capacity#switch-organizations) first.

<Frame caption="Current balance redacted for privacy.">
<img src="../static/images/billing/billing-purchase-credits.jpg" alt="Purchase Vapi credits dialog with the amount to purchase field" />
</Frame>
<Steps>
<Step title="Open Buy credits">
On the **Billing** page, select **Buy credits**.
</Step>
<Step title="Choose an amount">
Select a preset amount or enter a custom amount. A minimum purchase applies.
</Step>
<Step title="Confirm the purchase">
If you have a saved card, confirm to charge it. If you do not, enter card details first. Complete any verification your card issuer requests.
</Step>
<Step title="Verify the balance">
A successful purchase increases your credit balance and appears as **Finalized** in your purchase history.
</Step>
</Steps>

<Step title="Optional: Configure auto reload">
In **Payment method**, turn on **Enable auto reload**. Enter at least `$10` in **Amount to reload**, then enter the balance that should trigger the purchase in **When threshold reaches**.
## Set up auto-reload

Select **Save changes**, review the confirmation, then select **Confirm**. If the current balance is at or below the threshold, saving the plan charges the payment method immediately.
Auto-reload keeps your organization funded so usage is not interrupted. When the credit balance reaches a threshold you set, Vapi automatically purchases the top-up amount you choose.

<Frame>
<img src="../static/images/billing/billing-auto-reload.jpg" alt="Auto reload controls on the live Billing page" />
</Frame>
<Steps>
<Step title="Open auto-reload settings">
On the **Billing** page, open the auto-reload control.
</Step>

<Step title="Verify the billing setup">
Confirm that the page shows the saved payment method, updated credit balance, and auto reload settings. Check **Credit purchase history** for a **Finalized** payment.
<Step title="Set the top-up and threshold">
Turn on auto-reload, enter the amount to add each time, and enter the balance that should trigger a top-up.
</Step>
<Step title="Save">
Save your changes and confirm. If your current balance is already at or below the threshold, saving charges your default card immediately.
</Step>
</Steps>

## Download billing records
<Note>
With auto-reload off, usage can be interrupted when credits run out. Turn on auto-reload to keep the balance funded.
</Note>

Select **Download monthly statement** in **Credit purchase history** to create a statement for a selected month.
## Download statements and invoices

To download an invoice for an eligible payment, select the payment, then select **Download invoice (PDF)**. Enter the requested invoice information and select **Confirm**.
Download a statement or an invoice from your billing history for your records or accounting.

## Related
<Steps>
<Step title="Download a statement">
Open the **Payments** view and select **Download latest statement**. To download a different period, choose the month first.
</Step>
<Step title="Download an invoice">
Select an eligible payment, then select **Download invoice (PDF)** and enter the requested invoice details.
</Step>
</Steps>

<Card title="Vapi pricing" href="https://vapi.ai/pricing">
See current credit and per-minute rates on the official pricing page.
</Card>
## Related

<Card title="Troubleshoot call errors" href="/calls/troubleshoot-call-errors">
Resolve calls blocked by an insufficient credit balance or frozen subscription.
</Card>
<CardGroup cols={2}>
<Card title="Pricing and Success Packages" icon="fa-light fa-tags" href="/billing/pricing-and-success-packages">
Understand Usage only, optional Success Packages, and add-ons.
</Card>
<Card title="Manage Success Packages and add-ons" icon="fa-light fa-box" href="/billing/manage-packages-and-add-ons">
Change your Success Package and buy capacity or compliance add-ons.
</Card>
<Card title="Vapi pricing" icon="fa-light fa-money-check-dollar" href="https://vapi.ai/pricing">
See current credit and per-minute rates on the official pricing page.
</Card>
</CardGroup>
96 changes: 96 additions & 0 deletions fern/billing/manage-organizations-and-capacity.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
---
title: Manage organizations and capacity
subtitle: Create organizations, understand shared capacity, and resolve capacity before a downgrade
description: Learn how subscriptions provide organization capacity, how to create, move, and delete organizations, and what to resolve before reducing capacity.
slug: billing/manage-organizations-and-capacity
---

A subscription groups usage-based billing, an optional Success Package, add-ons, and one or more organizations. Usage only and each Success Package determine how many organizations the subscription can contain.

## Prerequisites

- An **Admin** role in the organization.

## Organization capacity

Organization capacity is the number of organizations that a subscription can contain. Usage only and each Success Package include an organization allowance. An organization add-on increases that allowance.

Creating another organization requires available capacity in the subscription.

## Create an organization

Create an organization to separate workspaces, teams, or environments under the same subscription.

<Steps>
<Step title="Open Organizations">
In the [Vapi Dashboard](https://dashboard.vapi.ai), open **Organizations**, then select **New organization**.
</Step>
<Step title="Enter the details">
Enter a name and admin email, and choose the subscription the organization belongs to.
</Step>
<Step title="Create">
Select **Create organization**.
</Step>
</Steps>

If no capacity remains, purchase an organization add-on or upgrade your Success Package before creating another organization. See [Buy capacity add-ons](/billing/manage-packages-and-add-ons#buy-capacity-add-ons).

## Switch organizations

Switch the active organization to work with its assistants, billing information, and settings.

<Steps>
<Step title="Open the organization switcher">
In the [Vapi Dashboard](https://dashboard.vapi.ai), select the current organization name to open the organization switcher.
</Step>
<Step title="Select an organization">
Search for or select the organization you want. The Dashboard switches to that organization's context.
</Step>
</Steps>

## Shared entitlements

Some entitlements apply across the subscription instead of to each organization separately. For example, concurrent call lines are shared by all organizations in the subscription.

Other entitlements can apply to each organization. Check the Success Package summary or your Premier agreement to confirm how a specific entitlement is measured.

## Delete an organization

<Warning>
Deleting an organization permanently removes its contents. Confirm that you no longer need its assistants, phone numbers, files, and other resources before deleting it.
</Warning>

Delete an organization you no longer need, for example to free an organization slot before reducing capacity.

<Steps>
<Step title="Open the organization">
In **Organizations** or **Org settings**, open the organization's menu and select **Delete organization from subscription**.
</Step>
<Step title="Confirm the organization">
Type the organization name to confirm.
</Step>
<Step title="Delete">
Select **Delete** to remove the organization permanently.
</Step>
</Steps>

## Reduce capacity or downgrade

Reducing organization capacity does not remove organizations automatically. Delete enough organizations before reducing capacity below the number in use.

A Success Package downgrade can also reduce organization capacity and shared entitlements. Resolve any capacity conflict before confirming the downgrade. See [Downgrade or remove a Success Package](/billing/manage-packages-and-add-ons#downgrade-or-remove-a-success-package).

## Premier subscriptions

Premier organization capacity and related entitlements depend on the customer agreement. Contact your account team to change custom limits.

## Related

<CardGroup cols={2}>
<Card title="Pricing and Success Packages" icon="fa-light fa-tags" href="/billing/pricing-and-success-packages">
Compare Usage only, Core, Pro, and Premier.
</Card>
<Card title="Manage Success Packages and add-ons" icon="fa-light fa-box" href="/billing/manage-packages-and-add-ons">
Change your Success Package and buy capacity or compliance add-ons.
</Card>
</CardGroup>
Loading
Loading