# Email Suspensions

Email / Email Suspensions

## Suspend email account incoming (SMTP) mail

 - [GET /Email/suspend_incoming](https://api.docs.cpanel.net/specifications/cpanel.openapi/email-suspensions/suspend_incoming.md): This function suspends incoming email for an account. The system will reject incoming email while the account is suspended.

Notes:

* The user can still log in to the email account. To suspend a user's ability to log in to, send mail from, and read their account, use the UAPI Email::suspend_login function.
* Use the UAPI Email::unsuspend_incoming function to allow the account to receive email.

Important:

When you disable the Receive Mail role, the system disables this function.

## Suspend email account login

 - [GET /Email/suspend_login](https://api.docs.cpanel.net/specifications/cpanel.openapi/email-suspensions/suspend_login.md): This function suspends a user's ability to log in to their email account. This function immediately suspends the user's login credentials and prevents future authenticated connections to the email account.

Notes:

* When you suspend an account, the user's account still receives email.
* To suspend incoming email for an account, use the UAPI Email::suspend_incoming function.
* To remove the login suspension for an account, use the UAPI Email::unsuspend_login function.

Important:

When you disable the Receive Mail role, the system disables this function.

## Suspend email account outgoing mail

 - [GET /Email/suspend_outgoing](https://api.docs.cpanel.net/specifications/cpanel.openapi/email-suspensions/suspend_outgoing.md): This function rejects outgoing mail for a suspended email account. This function does not disable a user's login credentials or access permissions to their email account.

Notes:

* To suspend a user's login credentials and prevent authenticated connections to the email account, use the UAPI Email::suspend_login function.
* To allow an email account to send mail, use the UAPI Email::unsuspend_outgoing function.
* To hold outgoing mail in Exim's queue, use the UAPI Email::hold_outgoing function.

Important:

When you disable the Send Mail role, the system disables this function.

## Unsuspend email account incoming mail

 - [GET /Email/unsuspend_incoming](https://api.docs.cpanel.net/specifications/cpanel.openapi/email-suspensions/unsuspend_incoming.md): This function unsuspends incoming email for an email account.

Important:

When you disable the Receive Mail role, the system disables this function.

## Unsuspend email account login

 - [GET /Email/unsuspend_login](https://api.docs.cpanel.net/specifications/cpanel.openapi/email-suspensions/unsuspend_login.md): This function restores a user's ability to log in to their email account.

Note:

* To suspend a user's ability to log in, use the UAPI Email::suspend_login function.
* To suspend incoming email for an account, use the UAPI Email::suspend_incoming function.

Important:

When you disable the Receive Mail role, the system disables this function.

## Unsuspend email account outgoing mail

 - [GET /Email/unsuspend_outgoing](https://api.docs.cpanel.net/specifications/cpanel.openapi/email-suspensions/unsuspend_outgoing.md): This function cancels the suspension action put in place by the UAPI Email::suspend_outgoing
function for outgoing mail for an email account.

Note:

To suspend an email account and reject all outgoing mail, use the UAPI Email::suspend_outgoing function.