When a domain completes one year and renews at the 12-month mark, the mailbox subscription price automatically increases to $5 per mailbox per month. This reflects updated licensing costs from our workspace vendors:These vendor costs increase for accounts that have been active for more than 12 months.
What Happens at 12 Months#
When your domain completes one year and if renewed, the mailbox subscription price increases:✓ The system automatically applies the new $5 per mailbox per month rate to all mailboxes.
✓ A subscription.updated webhook notification is sent to your endpoint
✓ You can use this notification to inform your customers of the price increase
Your Options#
Once a subscription enters the "one plus year" tier, you have two paths forward:Option 1: Accept the Updated Price#
Best for: Customers willing to continue at the new rateSubscription renews automatically at $5/mailbox/month
All mailboxes, domains, and configurations remain uninterrupted
This is the simplest option
Option 2: Recreate the Subscription#
Best for: Customers who need to keep their current pricingWhen you recreate a subscription:The existing workspace subscription is cancelled
A brand new subscription is provisioned for the same domain
All mailboxes and OAuth configuration are preserved
The new subscription restarts at standard pricing
You have another 12 months before the next price increase
Webhook Notification#
subscription.updated#
When a subscription crosses the 12-month threshold and pricing updates, a subscription.updated webhook event is sent to your registered webhook endpoint.
Recreation API#
Endpoint#
POST /component/subscriptions/recreate
Overview#
Cancel an existing workspace subscription and immediately provision a new one for the same domain. All mailboxes and OAuth configuration are preserved.Quick Request Example#
{
"subscriptionIds": ["<subscription_id>"]
}
{
"domainNames": ["yourdomain.com"]
}
What's Preserved#
✓ OAuth routes and client credentials
✗ One plus year pricing tier (new subscription starts at standard pricing)
Key Notes#
Recreation happens asynchronously — the response confirms the request is queued
Multiple domains can be recreated in a single request
Mailboxes are temporarily expired during the reprovisioning process (typically a few minutes)
No new charge is applied — the subscription inherits the billing context of the original
Summary#
| When | What Happens |
|---|
| Domain completes one year | At renewal, price increases to $5/mailbox/month |
| Price increase occurs | subscription.updated webhook is sent |
| You take no action | Subscription renews automatically at new price |
| You recreate subscription | New subscription provisioned at standard pricing (resets 12-month clock) |
Avoid These Common Issues#
Expecting repeated subscription.updated events: This webhook fires exactly once per subscription — the first time it crosses the 12-month mark. It will not fire again on later renewals.
Confusing recreate with cancel: Recreation preserves mailboxes and OAuth configuration and provisions a new subscription; cancellation deactivates mailboxes outright. Use the wrong one and you either lose mailboxes you meant to keep, or fail to reset pricing.
Assuming recreation is instant: POST /subscriptions/recreate is asynchronous — mailboxes are temporarily expired during reprovisioning (typically a few minutes) before the new subscription is active.
Reusing the old subscriptionId after recreation: Recreation provisions a new subscription with a new ID. Update any stored references — the old ID no longer resolves.
Next Steps#
Subscriptions
Full subscription lifecycle, statuses, and billing cycles.
Subscription Events
Full webhook payloads for every subscription event.
Domain Renewal
How domain renewal affects subscription renewal eligibility. Modified at 2026-08-05 16:12:50
