{"id":3004,"date":"2025-10-10T23:47:37","date_gmt":"2025-10-10T23:47:37","guid":{"rendered":"https:\/\/pheonixsolutions.com\/knowledge-base\/?p=3004"},"modified":"2026-03-16T11:27:58","modified_gmt":"2026-03-16T11:27:58","slug":"how-to-suspend-a-cpanel-account-via-cli-using-whmapi","status":"publish","type":"post","link":"https:\/\/pheonixsolutions.com\/knowledge-base\/2025\/10\/10\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\/","title":{"rendered":"How to Suspend a cPanel Account via CLI Using WHMAPI?"},"content":{"rendered":"\n<h3 class=\"wp-block-heading\">Introduction:<\/h3>\n\n\n\n<p>In web hosting environments managed through <strong>WHM\/cPanel<\/strong>, administrators often need to <strong>suspend user accounts<\/strong> for various reasons such as non-payment, abuse, or maintenance. While this can be done easily through the WHM interface, system administrators often prefer using the <strong>Command Line Interface (CLI)<\/strong> for automation, scripting, or remote administration.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Steps to Suspend a cPanel Account via CLI<\/h3>\n\n\n\n<p><strong>Step1:<\/strong><\/p>\n\n\n\n<p>Access WHM server using SSH as root user.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td>$ssh root@your-server-ip<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><strong>Step2:<\/strong><\/p>\n\n\n\n<p>Run the below WHMAPI Command to Suspend the Account.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td>$whmapi1 suspendacct user=USERNAME reason=&#8221;REASON_FOR_SUSPENSION&#8221;<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><strong>Example:<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td>$whmapi1 suspendacct user=testuser reason=&#8221;XXXXX&#8221;<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><strong>Explanation of parameters:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>user<\/code> \u2192 The cPanel username of the account you want to suspend.<\/li>\n\n\n\n<li><code>reason<\/code> \u2192 (Optional) A short note or description explaining why the account was suspended.<\/li>\n<\/ul>\n\n\n\n<p><strong>Step3:<\/strong><\/p>\n\n\n\n<p>We can confirm whether the account is successfully suspended by running.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td>$whmapi1 accountsummary user=USERNAME<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Look for the <code><strong><em>suspended: 1<\/em><\/strong><\/code> status in the output.<br>Alternatively, we can check via the WHM interface under List Accounts, where the account will appear as Suspended.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Conclusion:<\/h3>\n\n\n\n<p>Suspending a cPanel account via CLI using <strong>WHMAPI<\/strong> is a quick and efficient method for administrators who manage multiple accounts or automate routine hosting operations. It eliminates the need to log in to WHM manually and helps integrate account control into scripts or monitoring systems.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Introduction: In web hosting environments managed through WHM\/cPanel, administrators often need to suspend user accounts for various reasons such as non-payment, abuse, or maintenance. While this can be done easily through the WHM interface, system administrators often prefer using the Command Line Interface (CLI) for automation, scripting, or remote administration. Steps to Suspend a cPanel ..<\/p>\n<div class=\"clear-fix\"><\/div>\n<p><a href=\"https:\/\/pheonixsolutions.com\/knowledge-base\/2025\/10\/10\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\/\" title=\"read more...\">Read more<\/a><\/p>\n","protected":false},"author":6,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[3,33],"tags":[],"class_list":["post-3004","post","type-post","status-publish","format-standard","hentry","category-dedicated-hosting","category-whm"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.4 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>How to Suspend a cPanel Account via CLI Using WHMAPI? - PheonixSolutions Knowledge-Base<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/pheonixsolutions.com\/knowledge-base\/2025\/10\/10\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to Suspend a cPanel Account via CLI Using WHMAPI? - PheonixSolutions Knowledge-Base\" \/>\n<meta property=\"og:description\" content=\"Introduction: In web hosting environments managed through WHM\/cPanel, administrators often need to suspend user accounts for various reasons such as non-payment, abuse, or maintenance. While this can be done easily through the WHM interface, system administrators often prefer using the Command Line Interface (CLI) for automation, scripting, or remote administration. Steps to Suspend a cPanel ..Read more\" \/>\n<meta property=\"og:url\" content=\"https:\/\/pheonixsolutions.com\/knowledge-base\/2025\/10\/10\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\/\" \/>\n<meta property=\"og:site_name\" content=\"PheonixSolutions Knowledge-Base\" \/>\n<meta property=\"article:published_time\" content=\"2025-10-10T23:47:37+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-03-16T11:27:58+00:00\" \/>\n<meta name=\"author\" content=\"Saikrishna Areddy\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Saikrishna Areddy\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/2025\\\/10\\\/10\\\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/2025\\\/10\\\/10\\\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\\\/\"},\"author\":{\"name\":\"Saikrishna Areddy\",\"@id\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/#\\\/schema\\\/person\\\/8a5f4b5a8e71659e5a3bbee27663d9ba\"},\"headline\":\"How to Suspend a cPanel Account via CLI Using WHMAPI?\",\"datePublished\":\"2025-10-10T23:47:37+00:00\",\"dateModified\":\"2026-03-16T11:27:58+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/2025\\\/10\\\/10\\\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\\\/\"},\"wordCount\":218,\"commentCount\":0,\"articleSection\":[\"Dedicated Hosting\",\"WHM\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/2025\\\/10\\\/10\\\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/2025\\\/10\\\/10\\\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\\\/\",\"url\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/2025\\\/10\\\/10\\\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\\\/\",\"name\":\"How to Suspend a cPanel Account via CLI Using WHMAPI? - PheonixSolutions Knowledge-Base\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/#website\"},\"datePublished\":\"2025-10-10T23:47:37+00:00\",\"dateModified\":\"2026-03-16T11:27:58+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/#\\\/schema\\\/person\\\/8a5f4b5a8e71659e5a3bbee27663d9ba\"},\"breadcrumb\":{\"@id\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/2025\\\/10\\\/10\\\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/2025\\\/10\\\/10\\\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/2025\\\/10\\\/10\\\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to Suspend a cPanel Account via CLI Using WHMAPI?\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/#website\",\"url\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/\",\"name\":\"PheonixSolutions Knowledge-Base\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/#\\\/schema\\\/person\\\/8a5f4b5a8e71659e5a3bbee27663d9ba\",\"name\":\"Saikrishna Areddy\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/219fb50fa61a168b58a5e704d05058f958504aa8324675172185e3f0e8b3fd24?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/219fb50fa61a168b58a5e704d05058f958504aa8324675172185e3f0e8b3fd24?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/219fb50fa61a168b58a5e704d05058f958504aa8324675172185e3f0e8b3fd24?s=96&d=mm&r=g\",\"caption\":\"Saikrishna Areddy\"},\"url\":\"https:\\\/\\\/pheonixsolutions.com\\\/knowledge-base\\\/author\\\/saikrishna\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How to Suspend a cPanel Account via CLI Using WHMAPI? - PheonixSolutions Knowledge-Base","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/pheonixsolutions.com\/knowledge-base\/2025\/10\/10\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\/","og_locale":"en_US","og_type":"article","og_title":"How to Suspend a cPanel Account via CLI Using WHMAPI? - PheonixSolutions Knowledge-Base","og_description":"Introduction: In web hosting environments managed through WHM\/cPanel, administrators often need to suspend user accounts for various reasons such as non-payment, abuse, or maintenance. While this can be done easily through the WHM interface, system administrators often prefer using the Command Line Interface (CLI) for automation, scripting, or remote administration. Steps to Suspend a cPanel ..Read more","og_url":"https:\/\/pheonixsolutions.com\/knowledge-base\/2025\/10\/10\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\/","og_site_name":"PheonixSolutions Knowledge-Base","article_published_time":"2025-10-10T23:47:37+00:00","article_modified_time":"2026-03-16T11:27:58+00:00","author":"Saikrishna Areddy","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Saikrishna Areddy","Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/pheonixsolutions.com\/knowledge-base\/2025\/10\/10\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\/#article","isPartOf":{"@id":"https:\/\/pheonixsolutions.com\/knowledge-base\/2025\/10\/10\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\/"},"author":{"name":"Saikrishna Areddy","@id":"https:\/\/pheonixsolutions.com\/knowledge-base\/#\/schema\/person\/8a5f4b5a8e71659e5a3bbee27663d9ba"},"headline":"How to Suspend a cPanel Account via CLI Using WHMAPI?","datePublished":"2025-10-10T23:47:37+00:00","dateModified":"2026-03-16T11:27:58+00:00","mainEntityOfPage":{"@id":"https:\/\/pheonixsolutions.com\/knowledge-base\/2025\/10\/10\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\/"},"wordCount":218,"commentCount":0,"articleSection":["Dedicated Hosting","WHM"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/pheonixsolutions.com\/knowledge-base\/2025\/10\/10\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/pheonixsolutions.com\/knowledge-base\/2025\/10\/10\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\/","url":"https:\/\/pheonixsolutions.com\/knowledge-base\/2025\/10\/10\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\/","name":"How to Suspend a cPanel Account via CLI Using WHMAPI? - PheonixSolutions Knowledge-Base","isPartOf":{"@id":"https:\/\/pheonixsolutions.com\/knowledge-base\/#website"},"datePublished":"2025-10-10T23:47:37+00:00","dateModified":"2026-03-16T11:27:58+00:00","author":{"@id":"https:\/\/pheonixsolutions.com\/knowledge-base\/#\/schema\/person\/8a5f4b5a8e71659e5a3bbee27663d9ba"},"breadcrumb":{"@id":"https:\/\/pheonixsolutions.com\/knowledge-base\/2025\/10\/10\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/pheonixsolutions.com\/knowledge-base\/2025\/10\/10\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/pheonixsolutions.com\/knowledge-base\/2025\/10\/10\/how-to-suspend-a-cpanel-account-via-cli-using-whmapi\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/pheonixsolutions.com\/knowledge-base\/"},{"@type":"ListItem","position":2,"name":"How to Suspend a cPanel Account via CLI Using WHMAPI?"}]},{"@type":"WebSite","@id":"https:\/\/pheonixsolutions.com\/knowledge-base\/#website","url":"https:\/\/pheonixsolutions.com\/knowledge-base\/","name":"PheonixSolutions Knowledge-Base","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/pheonixsolutions.com\/knowledge-base\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/pheonixsolutions.com\/knowledge-base\/#\/schema\/person\/8a5f4b5a8e71659e5a3bbee27663d9ba","name":"Saikrishna Areddy","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/219fb50fa61a168b58a5e704d05058f958504aa8324675172185e3f0e8b3fd24?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/219fb50fa61a168b58a5e704d05058f958504aa8324675172185e3f0e8b3fd24?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/219fb50fa61a168b58a5e704d05058f958504aa8324675172185e3f0e8b3fd24?s=96&d=mm&r=g","caption":"Saikrishna Areddy"},"url":"https:\/\/pheonixsolutions.com\/knowledge-base\/author\/saikrishna\/"}]}},"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pheonixsolutions.com\/knowledge-base\/wp-json\/wp\/v2\/posts\/3004","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pheonixsolutions.com\/knowledge-base\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pheonixsolutions.com\/knowledge-base\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/pheonixsolutions.com\/knowledge-base\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/pheonixsolutions.com\/knowledge-base\/wp-json\/wp\/v2\/comments?post=3004"}],"version-history":[{"count":3,"href":"https:\/\/pheonixsolutions.com\/knowledge-base\/wp-json\/wp\/v2\/posts\/3004\/revisions"}],"predecessor-version":[{"id":3007,"href":"https:\/\/pheonixsolutions.com\/knowledge-base\/wp-json\/wp\/v2\/posts\/3004\/revisions\/3007"}],"wp:attachment":[{"href":"https:\/\/pheonixsolutions.com\/knowledge-base\/wp-json\/wp\/v2\/media?parent=3004"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pheonixsolutions.com\/knowledge-base\/wp-json\/wp\/v2\/categories?post=3004"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pheonixsolutions.com\/knowledge-base\/wp-json\/wp\/v2\/tags?post=3004"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}