• Account Management
  • Alias
  • Application
  • Application Admin
  • Application Licensing
  • Audit
  • Backup
  • Directory
  • Directory Admin
  • Group Admin
  • Group Level Admin
  • Groups
  • Groups Membership
  • LDAP Connection Pool
  • Look and Feel
  • Mail Server
  • Remember Me
  • SAML Configuration
  • Server Info
  • Sessions
  • Token
  • User Admin
  • User Authentication
  • Users
Server
Crowd Data Center / Reference / REST API

Mail Server

Postman Collection
OpenAPI
POST

Save configuration

Saves mail configuration

Request

Request bodyapplication/json

An entity with data required to connect to the server. OAuth2 authentication method requires browser initiated 'Authorize' action to be completed successfully. OAuth2 configuration id and mail server id should be included in the request.

addressToTest

string

from

string

host

string

id

string

jndiLocation

string

jndiMailActive

boolean

notificationEmails

array<string>

oauth2ConfigurationId

string

password

string

port

integer

Responses

returned if saving was success

POST/rest/admin/1.0/mail/configuration
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 curl --request POST \ --url 'http://{baseurl}/rest/rest/admin/1.0/mail/configuration' \ --header 'Content-Type: application/json' \ --data '{ "addressToTest": "<string>", "from": "<string>", "host": "<string>", "id": "<string>", "jndiLocation": "<string>", "jndiMailActive": true, "notificationEmails": [ "<string>" ], "oauth2ConfigurationId": "<string>", "password": "<string>", "port": 2154, "prefix": "<string>", "startTLS": "<string>", "timeout": 2154, "useSSL": "<string>", "username": "<string>" }'
POST

Test mail server connection

Tests connection to the specified SMTP server

Request

Request bodyapplication/json

An entity with data required to connect to the server. OAuth2 authentication method requires browser initiated 'Authorize' action to be completed successfully. OAuth2 configuration id and mail server id should be included in the request.

addressToTest

string

from

string

host

string

id

string

jndiLocation

string

jndiMailActive

boolean

notificationEmails

array<string>

oauth2ConfigurationId

string

password

string

port

integer

Responses

returned if the test was completed

application/json

any

POST/rest/admin/1.0/mail/configuration/test
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 curl --request POST \ --url 'http://{baseurl}/rest/rest/admin/1.0/mail/configuration/test' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "addressToTest": "<string>", "from": "<string>", "host": "<string>", "id": "<string>", "jndiLocation": "<string>", "jndiMailActive": true, "notificationEmails": [ "<string>" ], "oauth2ConfigurationId": "<string>", "password": "<string>", "port": 2154, "prefix": "<string>", "startTLS": "<string>", "timeout": 2154, "useSSL": "<string>", "username": "<string>" }'
200Response
1 2 3 4 { "logs": "Cannot connect to host `host.com`", "success": false }
POST

Validate fields

Validates fields required in test connection for mail server

Request

Request bodyapplication/json

An entity with data required to connect to the server. OAuth2 authentication method requires browser initiated 'Authorize' action to be completed successfully. OAuth2 configuration id and mail server id should be included in the request.

addressToTest

string

from

string

host

string

id

string

jndiLocation

string

jndiMailActive

boolean

notificationEmails

array<string>

oauth2ConfigurationId

string

password

string

port

integer

Responses

returned if validation was success

POST/rest/admin/1.0/mail/configuration/validate
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 curl --request POST \ --url 'http://{baseurl}/rest/rest/admin/1.0/mail/configuration/validate' \ --header 'Content-Type: application/json' \ --data '{ "addressToTest": "<string>", "from": "<string>", "host": "<string>", "id": "<string>", "jndiLocation": "<string>", "jndiMailActive": true, "notificationEmails": [ "<string>" ], "oauth2ConfigurationId": "<string>", "password": "<string>", "port": 2154, "prefix": "<string>", "startTLS": "<string>", "timeout": 2154, "useSSL": "<string>", "username": "<string>" }'

Rate this page: