> ## Documentation Index
> Fetch the complete documentation index at: https://api.smartlead.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Suspend Email Account

> Temporarily suspend an email account from all sending activities including campaigns and warmup

<Note>
  Suspending an email account prevents it from sending any emails in campaigns or warmup while keeping the account configuration intact. This is useful for troubleshooting issues or temporarily pausing an account without deletion.
</Note>

## Path Parameters

<ParamField path="email_account_id" type="number" required>
  The email account ID to suspend
</ParamField>

## Query Parameters

<ParamField query="api_key" type="string" required>
  Your SmartLead API key
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PUT "https://server.smartlead.ai/api/v1/email-accounts/suspend/123?api_key=YOUR_KEY"
  ```

  ```python Python theme={null}
  import requests

  API_KEY = "YOUR_API_KEY"
  account_id = 123

  response = requests.put(
      f"https://server.smartlead.ai/api/v1/email-accounts/suspend/{account_id}",
      params={"api_key": API_KEY}
  )

  result = response.json()
  if result.get('success'):
      print(f"Email account {account_id} suspended successfully")
  ```

  ```javascript JavaScript theme={null}
  const API_KEY = 'YOUR_API_KEY';
  const accountId = 123;

  const response = await fetch(
    `https://server.smartlead.ai/api/v1/email-accounts/suspend/${accountId}?api_key=${API_KEY}`,
    { method: 'PUT' }
  );

  const result = await response.json();
  if (result.success) {
    console.log(`Email account ${accountId} suspended successfully`);
  }
  ```
</RequestExample>

## Response Codes

<ResponseField name="200" type="Success">
  Email account suspended successfully
</ResponseField>

<ResponseField name="400" type="Bad Request">
  Invalid account ID or account not found
</ResponseField>

<ResponseField name="401" type="Unauthorized">
  Invalid or missing API key
</ResponseField>

<ResponseField name="500" type="Internal Server Error">
  Server error occurred
</ResponseField>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "success": true,
    "message": "Email account suspended successfully",
    "data": {
      "accountId": 123,
      "isSuspended": true
    }
  }
  ```

  ```json 400 - Account Not Found theme={null}
  {
    "success": false,
    "message": "Email account not found or does not belong to you"
  }
  ```

  ```json 400 - Invalid ID theme={null}
  {
    "success": false,
    "message": "Valid account ID is required"
  }
  ```

  ```json 401 - Unauthorized theme={null}
  {
    "message": "Invalid API Key"
  }
  ```
</ResponseExample>

## Suspension Behavior

<Info>
  When an email account is suspended:

  * The `is_suspended` flag is set to `true`
  * The account stops sending campaign emails immediately
  * Warmup emails are also paused
  * The account remains in campaign configurations but won't be used for sending
  * All account data and configurations are preserved
</Info>

<Tip>
  Use suspension instead of deletion when you need to:

  * Temporarily troubleshoot connection issues
  * Pause an account during maintenance
  * Test campaign performance without this account
  * Investigate deliverability problems
</Tip>

## Related Endpoints

* [Unsuspend Email Account](/api-reference/email-accounts/unsuspend)
* [Delete Email Account](/api-reference/email-accounts/delete) - Permanent removal
* [Get Email Account by ID](/api-reference/email-accounts/get-by-id)