One Plus Year Subscription Overview

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:

Google Workspace

Microsoft 365

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 rate

No action required

Subscription 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 pricing

When 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

Note: Use the Recreation API to trigger this action.

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.

Details: See Webhook — subscription.updated for the complete payload structure and event fields.

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

By subscription ID:

{
  "subscriptionIds": ["<subscription_id>"]
}

By domain name:

{
  "domainNames": ["yourdomain.com"]
}

What's Preserved

✓ Mailboxes

✓ OAuth routes and client credentials

✓ Auto-renew setting

✗ 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

For complete API details, validations, and error codes, see the full Recreation API documentation.

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)

One Plus Year Subscription Overview

What Happens at 12 Months#

Your Options#

Option 1: Accept the Updated Price#

Option 2: Recreate the Subscription#

Webhook Notification#

subscription.updated#

Recreation API#

Endpoint#

Overview#

Quick Request Example#

What's Preserved#

Key Notes#

Summary#