Test sending an email message

This endpoint allows you to send a test email using the configured SMTP integration settings. It is used to verify that the provided SMTP credentials (such as host, port, username, and password) are working correctly and can be used to send emails.

Use this endpoint to ensure that your SMTP integration is properly set up before enabling real transactional or notification emails in your application.

Test sending an email message

post

Header parameters

Brand-URLstringRequired

The brand URL of the request. This is used to identify the brand.

Example: YOUR_BRAND_URL

Auth-KeystringRequired

Auth-Key is required to authenticate the request. If missing, the server will return 401 Unauthorized.

Example: YOUR_AUTH_KEY

Body

application/jsontext/jsonapplication/*+json

hoststring · min: 1Required

The SMTP server hostname or IP (e.g., smtp.gmail.com).

portinteger · int32Required

The port number for the SMTP server (typically 587 or 465).

usernamestring · min: 1Required

The username/email address for SMTP authentication.

passwordstring · min: 1Required

The password for SMTP authentication.

useTlsbooleanRequired

Whether to enable SSL for SMTP connection.

emailAddressFromstring · min: 1Required

The sender email address.

emailAddressTostring · min: 1Required

The recipient email address.

subjectstring · min: 1Required

The subject of the test email.

bodystring · min: 1Required

The body content of the test email.

Responses

200

The request was successful.

application/json

This provides interfaces for API responses with data.

successbooleanRead-onlyRequired

This is the flag to indicate whether the API call is successful or not.

statusCodeinteger · int32Read-onlyRequired

This is the HTTP status code. This is used to determine the status code to be returned to the client.

messagestring · min: 1Read-onlyRequired

This is the message to be displayed to the user.

databooleanRead-onlyOptional

This is the data to be returned to the client.

401

The user is not authorized to access the requested resource. The request is missing the required Auth-Key header.

application/json

403

The user's access was denied.

application/json

429

API call exceeded rate limit due to too many requests.

application/json

post

/api/v1/app-integrations/smtp/test

HTTPcURLJavaScriptPython

POST /api/v1/app-integrations/smtp/test HTTP/1.1
Host: protocol.jframework.io
Brand-URL: text
Auth-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "host": "text",
  "port": 1,
  "username": "text",
  "password": "text",
  "useTls": true,
  "emailAddressFrom": "text",
  "emailAddressTo": "text",
  "subject": "text",
  "body": "text"
}

application/jsontext/jsonapplication/*+json

{
  "success": true,
  "statusCode": 200,
  "message": "The request was successful.",
  "data": true,
  "errors": []
}