---
title: "Test custom S3 connection"
method: POST
path: "/v1/domains/{domain_id}/test-s3-connection"
tags: ["Domains"]
---

# Test custom S3 connection

`POST /v1/domains/{domain_id}/test-s3-connection`

## Request

- Base URL: `https://api.forwardemail.net`
- URL: `https://api.forwardemail.net/v1/domains/{domain_id}/test-s3-connection`
- Auth: HTTP basic

Tests the custom S3 storage connection for the specified domain. Verifies that the configured credentials are valid, the bucket exists, and write permissions are available. The domain must have custom S3 storage enabled and configured before testing.

## Path parameters

- `domain_id` string, required

## Response `200`

S3 connection test successful

- object
  - `message` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/forwardemail/apis/forward-email-api.md) · [All operations](https://skmtc.dev/forwardemail/apis/forward-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forwardemail/apis/forward-email-api/revisions/ecefab4527f6?raw)