Suspend an ACME account

The SUSPENDACCOUNT action suspends one or more active or pending ACME accounts. This action is useful when you want to prevent ACME accounts from being used to request certificates without fully deactivating them. It can be used to suspend a single ACME account, all ACME accounts that share the same EAB details, or all ACME accounts associated with the specified Sectigo Reseller account (loginName).

In the case where all ACME accounts sharing the same EAB details or all ACME accounts associated with the specified Sectigo Reseller account are suspended, the corresponding EAB details are also suspended and cannot be used to create new ACME accounts.

ACME account suspension can be temporary or permanent. For information on reinstating suspended accounts, see Reinstate an ACME account

Action: SUSPENDACCOUNT

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: SUSPENDACCOUNT.

acmeAccountID

string

32 chars

(Conditional) The Base64 url encoded ACME account ID of the ACME account to be suspended.

Exclude when includeAdditionalAccounts is set to *.

includeAdditionalAccounts

string

1 char

Indicates whether to suspend all accounts that share the same EAB details.

The possible values are:

  • Y — (Default) Suspend all accounts that share the same EAB details, and EAB details themselves.

  • N — Suspend only the specified account.

  • * — Suspend all accounts and all the corresponding EAB details associated with the specified Sectigo account (loginName).

Sample request

Suspend an ACME account
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=SUSPENDACCOUNT' \
--data-urlencode 'acmeAccountID=ABc_123xYZ456' \
--data-urlencode 'includeAdditionalAccounts=N'
Suspend all ACME accounts sharing EAB credentials
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=SUSPENDACCOUNT' \
--data-urlencode 'acmeAccountID=ABc_123xYZ456' \
--data-urlencode 'includeAdditionalAccounts=Y'
Suspend all ACME accounts belonging to an external account
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=SUSPENDACCOUNT' \
--data-urlencode 'includeAdditionalAccounts=*'

Success response

{
    "nRecordsUpdated": 10,
    "success": true
}