- Litemail Docs
- Users
- Workspaces
- Billings
- Mailboxes
- Payment & Wallet
- Exports
- Subscriptions
- Domains
- Retrieve DomainsGET
- List Assignable DomainsGET
- Add DMARC RecordsPOST
- Add Domain ForwardingPOST
- Remove Domain ForwardingDELETE
- Get Name ServersGET
- Verify Name Server PropagationGET
- Connect Domains with ZapmailPOST
- Enable Email ForwardingPOST
- Remove Email ForwardingDELETE
- Enable Catch-All EmailsPOST
- Remove Catch-All EmailsDELETE
- Check DNS RecordsGET
- Remove Unused DomainDELETE
- Get Available Domains for RegistrationGET
- Get Domain Purchase Payment LinkGET
- Retrieve Domains
- DNS
- apikeys testing
- Connect Inbox
Upgrade Subscription
PUT
/v1/subscriptions/{subscriptionId}/upgrade
Request
Authorization
JWT Bearer
Add the parameter
Authorization
to Headers，whose value is to concatenate the Token after the Bearer eyJhbGciOiJSUzI1NiIsImNhdCI6ImNsX0I3ZDRQRDExMUFBQSIsImtpZCI6Imluc18zM1FqbUNRdUNYcU1USUpxeVZvYXVXNUtWckgiLCJ0eXAiOiJKV1QifQ.eyJhenAiOiJodHRwczovL2FwcC5saXRlbWFpbC5haSIsImV4cCI6MTc2OTcyNTc2NSwiZnZhIjpbMCwtMV0sImlhdCI6MTc2OTcyNTcwNSwiaXNzIjoiaHR0cHM6Ly9jbGVyay5saXRlbWFpbC5haSIsIm5iZiI6MTc2OTcyNTY5NSwic2lkIjoic2Vzc18zOHd6dlhoM0N5Vm16a0NsaGk0MWx6WEhoTXciLCJzdHMiOiJhY3RpdmUiLCJzdWIiOiJ1c2VyXzM0aEk2THFBazNPdUlWVDNaZmpuYldRY2pPMiIsInYiOjJ9.2C1vleGX50Q3Z7D1HTH_3xGaTrxnEVwBc1n1EsqZSjQFKriztJXv7VYRUsBRIDH4npejsCcZagNctwS6Hz8tiS_7ggC22UGJbOENmTQCB7V8Ejcl6hC_qH-9Ovmi_6kcmQ9pwT6W4yWSelpm_jDVkDGmGS6GBEsupZYL-FKZpTPGdvlRP0JF8c1U6Z_XaXUH63DHQkcRYMxcQCmZEH7I6jPbyKgUxcL2n7tdBHZcrxAOp5vYlP4Q9aViaVI_ETkDAPm4GqrzL2y5UZKo-mwaiyj4diYX3p1stnHsYgV09MVQny-TCKsoJ_DEukt85GCyWe2SiwA32eCGp5eU-lKnTw.Example:
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImNhdCI6ImNsX0I3ZDRQRDExMUFBQSIsImtpZCI6Imluc18zM1FqbUNRdUNYcU1USUpxeVZvYXVXNUtWckgiLCJ0eXAiOiJKV1QifQ.eyJhenAiOiJodHRwczovL2FwcC5saXRlbWFpbC5haSIsImV4cCI6MTc2OTcyNTc2NSwiZnZhIjpbMCwtMV0sImlhdCI6MTc2OTcyNTcwNSwiaXNzIjoiaHR0cHM6Ly9jbGVyay5saXRlbWFpbC5haSIsIm5iZiI6MTc2OTcyNTY5NSwic2lkIjoic2Vzc18zOHd6dlhoM0N5Vm16a0NsaGk0MWx6WEhoTXciLCJzdHMiOiJhY3RpdmUiLCJzdWIiOiJ1c2VyXzM0aEk2THFBazNPdUlWVDNaZmpuYldRY2pPMiIsInYiOjJ9.2C1vleGX50Q3Z7D1HTH_3xGaTrxnEVwBc1n1EsqZSjQFKriztJXv7VYRUsBRIDH4npejsCcZagNctwS6Hz8tiS_7ggC22UGJbOENmTQCB7V8Ejcl6hC_qH-9Ovmi_6kcmQ9pwT6W4yWSelpm_jDVkDGmGS6GBEsupZYL-FKZpTPGdvlRP0JF8c1U6Z_XaXUH63DHQkcRYMxcQCmZEH7I6jPbyKgUxcL2n7tdBHZcrxAOp5vYlP4Q9aViaVI_ETkDAPm4GqrzL2y5UZKo-mwaiyj4diYX3p1stnHsYgV09MVQny-TCKsoJ_DEukt85GCyWe2SiwA32eCGp5eU-lKnTw ********************or
Path Params
Body Params application/jsonRequired
Example
{
"newPlan": "Pro"
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT '/v1/subscriptions//upgrade' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImNhdCI6ImNsX0I3ZDRQRDExMUFBQSIsImtpZCI6Imluc18zM1FqbUNRdUNYcU1USUpxeVZvYXVXNUtWckgiLCJ0eXAiOiJKV1QifQ.eyJhenAiOiJodHRwczovL2FwcC5saXRlbWFpbC5haSIsImV4cCI6MTc2OTcyNTc2NSwiZnZhIjpbMCwtMV0sImlhdCI6MTc2OTcyNTcwNSwiaXNzIjoiaHR0cHM6Ly9jbGVyay5saXRlbWFpbC5haSIsIm5iZiI6MTc2OTcyNTY5NSwic2lkIjoic2Vzc18zOHd6dlhoM0N5Vm16a0NsaGk0MWx6WEhoTXciLCJzdHMiOiJhY3RpdmUiLCJzdWIiOiJ1c2VyXzM0aEk2THFBazNPdUlWVDNaZmpuYldRY2pPMiIsInYiOjJ9.2C1vleGX50Q3Z7D1HTH_3xGaTrxnEVwBc1n1EsqZSjQFKriztJXv7VYRUsBRIDH4npejsCcZagNctwS6Hz8tiS_7ggC22UGJbOENmTQCB7V8Ejcl6hC_qH-9Ovmi_6kcmQ9pwT6W4yWSelpm_jDVkDGmGS6GBEsupZYL-FKZpTPGdvlRP0JF8c1U6Z_XaXUH63DHQkcRYMxcQCmZEH7I6jPbyKgUxcL2n7tdBHZcrxAOp5vYlP4Q9aViaVI_ETkDAPm4GqrzL2y5UZKo-mwaiyj4diYX3p1stnHsYgV09MVQny-TCKsoJ_DEukt85GCyWe2SiwA32eCGp5eU-lKnTw <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"newPlan": "Pro"
}'Responses
🟢200OK
application/json
Body
Example
{
"status": 200,
"message": "Subscription upgraded successfully",
"data": {
"id": "sub_1",
"oldPlan": "Basic",
"newPlan": "Pro",
"upgradedAt": "2025-10-04T16:00:00Z"
}
}