Remove a domain

The REMOVEDOMAIN action removes a specified fully qualified domain name (FQDN) or wildcard domain from your subscription.

If a paid domain is removed and another associated domain in the subscription was added for free, both domains will be removed. If a domain that was added for free is removed, it is removed alone.

To avoid unwanted charges, we recommend removing domain names that are no longer in use before extending the subscription. For more information, see Subscription overview.

Standalone domain subscriptions

  • Domains can be removed at any time during the subscription validity period or grace period.

  • Removing a domain within 30 days of adding it results in an automatic full refund of the associated order.

Bundle-based subscriptions

  • A domain can be removed freely before certificate issuance. In this case, the corresponding domain slot is returned to the Wallet.

  • Once a certificate has been issued, the domain remains part of the subscription and can only be removed during the subscription extension window. The corresponding domain slot is released once the subscription is extended, and a new domain can be added to use this domain slot.

If a domain was mistakenly added with an incorrect spelling and then removed, you can re-add it with the correct spelling using the ADDDOMAIN action. For more information, see Add a domain.

Action: REMOVEDOMAIN

Variable Name Type Max. Length Description

loginName

string

64 chars

Your account username.

This value is case sensitive.

loginPassword

string

128 chars

Your account password.

This value is case sensitive.

action

string

30 chars

The action to be taken.

In this case, the value is: REMOVEDOMAIN.

acmeAccountID

string

32 chars

Your Base64 URL-encoded ACME account ID.

domainName

string

255 chars

Your FQDN or wildcard domain name.

Sample request

curl --location --request POST 'https://secure.trust-provider.com/products/!ACMEAdmin' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'loginName=loginName' \
--data-urlencode 'loginPassword=loginPassword' \
--data-urlencode 'action=REMOVEDOMAIN' \
--data-urlencode 'acmeAccountID=ABc_123xYZ456' \
--data-urlencode 'domainName=domain.com'

Response

Response parameters

The response may contain the following parameters:

Parameter Type Description

success

boolean

Indicates whether the request was successful.

Domains

array

An array of objects containing the domain names that were removed.

The beginning of the Domains array

domainName

string

The fully qualified domain name (FQDN) or wildcard domain that was removed.

Sample success response

{
    "success": true,
    "Domains": [
        {
            "domainName": "domain.com"
        },
        {
            "domainName": "www.domain.com"
        }
    ]
}