	Description
URI	http://host_name/uc/resources/emailconnection
HTTP Method	POST
Description	Creates an Email Connection.
Example URI	http://localhost:8080/uc/resources/emailconnection
Consumes Content-Type	application/xml, application/json
Produces Content-Type	n/a
Example Request	See Create an Email Connection: Example Request, below.
Example Response	Status 200 /OK Successfully created the Email Connection with sysId {sysId}. Status 400 /Bad Request Create Email Connection failed. A duplicate value has been detected. Name must be unique.
Email Connection Properties	See Email Connection Properties, below.

Anchor
Create an Email Connection Example Request
Create an Email Connection Example Request
Create an Email Connection: Example Request

XML Request

JSON Request

Expand

title	XML Request

<emailConnection exportReleaseLevel="7.3.0.0" exportTable="ops_email_connection" retainSysIds="true" version="3">
    <authentication>true</authentication>
    <defaultPwd>abc1<authenticationType>Password</defaultPwdauthenticationType>
    <defaultUser>user1<>jane.doe@stonebranch.com</defaultUser>
    <description>description< /description>
    <emailAddr>jane.doe@stonebranch.com</emailAddr>
    <imap />
    <imapPort >143</imapPort>
    <imapSsl>true<>false</imapSsl>
    <imapStarttls>false</imapStarttls>
    <name>Email Connection 1</name>
    <oauthClient />
    <opswiseGroups />
    <smtp>server1<>smtp.gmail.com</smtp>
    <smtpPort>4567<>465</smtpPort>
    <smtpSsl>true</smtpSsl>
    <smtpStarttls>false</smtpStarttls>
    <sysId>62701879a6264107bb757a952bcc65cc<>3b2c5049632841189888c921f9584edf</sysId>sysId>
    <systemConnection>true<>false</systemConnection>
    <trashFolder />
    <type>Outgoing</type>
</emailConnection>

Expand

title	JSON Request

{
    "authentication" : true,
 
  "defaultPwdauthenticationType" : "abc1Password",
 
  "defaultUser" : "user1jane.doe@stonebranch.com",
 
  "description" : "description"null,
 
  "emailAddr" : "jane.doe@stonebranch.com",
  "exportReleaseLevel" : "imap": null7.3.0.0",
  "exportTable" : "imapPort": null,
 ops_email_connection",
  "imapSslimap" : truenull,
  "imapPort" : 143,
  "imapStarttlsimapSsl" : nullfalse,
  "imapStarttls" : false,
  "name" : "Email Connection 1",
  "oauthClient" : null,
  "opswiseGroups" : null[ ],
    "retainSysIds" : true,
 
  "smtp" : "server1smtp.gmail.com",
 
  "smtpPort" : 4567465,
    "smtpSsl" : true,
 
  "smtpStarttls" : false,
  "sysId" : "systemConnection3b2c5049632841189888c921f9584edf":,
true,     "sysIdsystemConnection" : "62701879a6264107bb757a952bcc65cc"false,
    "trashFolder" : null,
 
  "type" : "Outgoing",
  "version" : 3
}

Anchor
Email Connection Properties
Email Connection Properties
Email Connection Properties

defaultPwd defaultPwd defaultPwdPassword authentication = Password; Password that the Controller will use to connect to the server.

If defaultPwd is omitted in the request, it will be ignored.

If defaultPwd is provided in the request, it will be updated.defaultUser defaultUser defaultUserUser name Ndescription description descriptionemailAddrexportReleaseLevelexportTable

Property

UI Field Name

Description

Specifications

Required

Anchor

	authentication - Email
	authentication - Email

authentication

Authentication Required

Deprecated. If type = Outgoing; Specification for whether or not defaultUser and password are required.

Boolean; Valid values: true/false. Default is false.

N

Anchor

	authenticationType - Email
	authenticationType - Email

authenticationType

Authentication

Method of authentication.

Valid values (case-insensitive):

As String = None, As Value = 0
As String = Password, As Value = 1
As String = OAuth 2.0, As Value = 2

N

Anchor

	authorized - Email

	authorized - Email

authorized

Is Authorized

If

authenticationType = OAuth 2.0; Specification for whether or not the email connection is authorized.

Boolean; read only

N

Anchor

	defaultPwd - Email

	defaultPwd - Email

defaultPwd

User Name

Password

If type = Outgoing and authenticationType = Password; Password that the Controller will use to connect to the server.

Y (if type is Outgoing and authenticationType is Password)

Anchor

	defaultUser - Email

	defaultUser - Email

defaultUser

Description

Description of this record.

N

Anchor

emailAddr - Email

Email Address

If type = Outgoing; Email address of the sender.

Y

Anchor

exportReleaseLevel - Email

n/a

Universal Controller release that the record was exported from.

read only

N

Anchor

exportTable - Email

n/a

User Name

If type = Outgoing and authenticationType = Password or OAuth 2.0 or if type = Incoming and authenticationType = OAuth 2.0; User Name that the Controller will use to connect to the server.

Y (if type is Outgoing and authenticationType is Password or OAuth 2.0 or if type is Incoming and authenticationType is OAuth 2.0)

Anchor

	description - Email
	description - Email

description

Description

Description of this record.

N

Anchor

	emailAddr - Email
	emailAddr - Email

emailAddr

Email Address

If type = Outgoing; Email address of the sender.

Y

Anchor

	exportReleaseLevel - Email
	exportReleaseLevel - Email

exportReleaseLevel

n/a

Universal Controller release that the record was exported from.

read only

N

Anchor

	exportTable - Email
	exportTable - Email

exportTable

n/a

Record table information.

read only

N

Anchor

	imap - Email
	imap - Email

imap

Incoming Mail Server (IMAP)

If type = Incoming; Name or IP address of the incoming email server.

Y

Anchor

	imapPort - Email
	imapPort - Email

imapPort

IMAP Port

If type = Incoming; Port on the machine where the incoming email server resides.

Y

Anchor

	imapSsl - Email
	imapSsl - Email

imapSsl

Enable SSL

If type = Incoming; Specification for whether or not SSL/TLS connectivity is enabled for your server.

Boolean; Valid values: true/false. Default is false.

N

Anchor

	imapStarttls - Email
	imapStarttls - Email

imapStarttls

Enable STARTTLS

If type = Incoming; Specification for whether or not the use of the STARTTLS command (if supported by the server) is enabled to switch the connection to a TLS-protected connection before issuing any login commands. (An appropriate trust store must be configured so that the client will trust the server's certificate. )

N

Anchor

	name - Email
	name - Email

name

Connection Name

Name used within the Controller to identify this Email Connection.

Y

Anchor

	oauthClient

OAuth Client

- Email
	oauthClient - Email

oauthClient

OAuth Client

The OAuth client used to authorize the email connection.

Y (if authenticationType is OAuth 2.0)

Anchor

	opswiseGroups - Email
	opswiseGroups - Email

opswiseGroups

Member of Business Services

Business Services that this record belongs to.

XML

Panel
<opswiseGroups> <opswiseGroup>group1</opswiseGroup> <opswiseGroup>group2</opswiseGroup> </opswiseGroups>

JSON

Panel
"opswiseGroups": ["group1","group2"]

N

Anchor

	smtp - Email
	smtp - Email

smtp

Outgoing Mail Server (SMTP)

If type = Outgoing; Name or IP address of the outgoing email server.

Y

Anchor

	smtpPort - Email
	smtpPort - Email

smtpPort

SMTP Port

If type = Outgoing; Port on the machine where the outgoing email server resides.

Y

Anchor

	smtpSsl - Email
	smtpSsl - Email

smtpSsl

Enable SSL

If type = Outgoing; Specification for whether or not SSL/TLS connectivity is enabled for your server.

Boolean; Valid values: true/false. Default is false.

N

Anchor

	smtpStarttls - Email
	smtpStarttls - Email

smtpStarttls

Enable STARTTLS

If type = Outgoing; Specification for whether or not the use of the STARTTLS command (if supported by the server) is enabled to switch the connection to a TLS-protected connection before issuing any login commands. (An appropriate trust store must be configured so that the client will trust the server's certificate. )

N

Anchor

	sysId - Email
	sysId - Email

sysId

n/a

System ID field in the database for this Email Connection record.

Persisted only if retainSysIds is set to true.

N

Anchor

	systemConnection - Email
	systemConnection - Email

systemConnection

Use for System Notifications

If type = Outgoing; Specification for whether or not this Email Connection is to be used for system notifications.

Boolean; Valid values: true/false. Default is false.

Y

Anchor

	trashFolder- Email
	trashFolder- Email

trashFolder

Trash Folder

If type = Incoming; Folder to use for deleted emails.

N

Anchor

	type - Email
	type - Email

type

Connection Type

Type of Email Connection.

Note

title	Note:

You cannot modify the type after the Email Connection has been created.

Valid Values:

As String = Outgoing, As Value = 1
As String = Incoming, As Value = 2

Default is Outgoing (1)

Y

Anchor
Delete an Email Connection
Delete an Email Connection
Delete an Email Connection

...

	Description
URI	http://host_name/uc/resources/emailconnection/list
HTTP Method	GET
Description	Retrieves information on all Email Connections.
Example URI	http://localhost:8080/uc/resources/emailconnection/list
Authentication	HTTP Basic
Consumes Content-Type	n/a
Produces Content-Type	application/xml, application/json
Example Response	See List Email Connections: Example Response, below.
Email Connection Properties	See Email Connection Properties.

Anchor
List Email Connections Example Response
List Email Connections Example Response
List Email Connections: Example Response

XML Response

JSON Response

Expand

title	XML ResponseRequest

<emailConnections>
    <emailConnection <emailConnection exportReleaseLevel="7.23.0.0" exportTable="ops_email_connection" versionretainSysIds="7true">
        <authentication>true</authentication>
        <defaultUser>user1</defaultUser>
        <description>description</description>
        <emailAddr>jane.doe@stonebranch.com</emailAddr>
        <imap />
        <imapPort />
        <imapSsl>true</imapSsl>
        <imapStarttls>false</imapStarttls>
        <name>Email Connection 1</name>
        <opswiseGroups />
        <smtp>server1</smtp>
        <smtpPort>4567</smtpPort>
        <smtpSsl>true</smtpSsl>
        <smtpStarttls>false</smtpStarttls>
        <sysId>62701879a6264107bb757a952bcc65cc</sysId>
        <systemConnection>true</systemConnection>
        <trashFolder />
        <type>Outgoing</type>
    </emailConnection>
    <emailConnection exportReleaseLevel="7.2.0.0" exportTable="ops_email_connection" version="2">
        <authentication>true</authentication>
        <defaultUser>user2</defaultUser>
        <description>description</description>
        <emailAddr>john.doe@stonebranch.com</emailAddr>
        <imap />
        <imapPort />
        <imapSsl>true</imapSsl>
        <imapStarttls>false</imapStarttls>
        <name>Email Connection 2</name>
        <opswiseGroups />
        <smtp>server2</smtp>
        <smtpPort>4568</smtpPort>
        <smtpSsl>true</smtpSsl>
        <smtpStarttls>false</smtpStarttls>
        <sysId>62701879a6264107bb757a952bcc65cc</sysId>
        <systemConnection>true</systemConnection>
        <trashFolder />
  version="3">
      <type>Outgoing<authentication>true</typeauthentication>
    <authenticationType>Password</emailConnection>
<emailConnections>

Expand

title	JSON Response

{authenticationType>
     "authentication": true,
    "defaultUser": "user1",
    "description": "description",<authorized>false</authorized>
    <defaultUser>jane.doe@stonebranch.com</defaultUser>
    "emailAddr": "jane.doe@stonebranch.com",
<description />
   "exportReleaseLevel": "7.2.0.0",
 <emailAddr>jane.doe@stonebranch.com</emailAddr>
   "exportTable": "ops_email_connection",
    "imap": null, <imap />
    "imapPort": null,<imapPort>143</imapPort>
     "imapSsl": true,<imapSsl>false</imapSsl>
     "imapStarttls": null,<imapStarttls>false</imapStarttls>
     "name": "Email Connection 1",
    "opswiseGroups": null,
<name>Email Connection 1</name>
    <oauthClient />
    <opswiseGroups/>
   "retainSysIds": true, <smtp>smtp.gmail.com</smtp>
    "smtp": "server1",<smtpPort>465</smtpPort>
     "smtpPort": 4567,<smtpSsl>true</smtpSsl>
    <smtpStarttls>false</smtpStarttls>
 "smtpSsl": true,   <sysId>3b2c5049632841189888c921f9584edf</sysId>
 "smtpStarttls": false,  <systemConnection>false</systemConnection>
  "systemConnection": true, <trashFolder />
  "sysId": "62701879a6264107bb757a952bcc65cc",
  <type>Outgoing</type>
</emailConnection>

Expand

title	JSON Request

Expand

title	JSON Request

{
  "

trashFolder

authentication" :

null

true,

type

authenticationType" : "

Outgoing

Password",

}

authentication

authorized" :

true

false,

 "defaultUser" : "

user2

jane.doe@stonebranch.com",

 "description" :

"description"

null,

 "emailAddr" : "

john

jane.

doe@stonebranch

doe@stonebranch.com",

"exportReleaseLevel" : "7.

2

3.0.0",

"exportTable" : "ops_email_connection",


  "imap" : null,

 "imapPort" :

null

143,

  "imapSsl" :

true

false,

 "imapStarttls" :

null

false,

 "name" : "Email Connection 1",


  "oauthClient" : null,
  "opswiseGroups" : [

null

],

  "retainSysIds" : true,

 "smtp" : "

server2

smtp.gmail.com",

 "smtpPort" :

4568

465,

  "smtpSsl" : true,

  "smtpStarttls" : false,

systemConnection

sysId" :

true

"3b2c5049632841189888c921f9584edf",

sysId

systemConnection" :

"62701879a6264107bb757a952bcc65cc"

false,

 "trashFolder" : null,

  "type" : "Outgoing"

,
  "version" : 3
}

Anchor
Modify an Email Connection
Modify an Email Connection
Modify an Email Connection

	Description
URI	http://host_name/uc/resources/emailconnection
HTTP Method	PUT
Description	Modifies the Email Connection specified by the `sysId`.
Example URI	http://localhost:8080/uc/resources/emailconnection
Consumes Content-Type	application/xml, application/json
Produces Content-Type	n/a
Example Request	See Modify an Email Connection: Example Request, below.
Email Connection Properties	See See Email Connection Properties.
Example Response	Status 200 /OK Successfully updated the Email Connection with sysId <sysId> to version <version>.

...

URI	http://host_name/uc/resources/emailconnection
HTTP Method	GET
Description	Retrieves information on a specific Email Connection.
URI Parameters	See Read an Email Connection: URI Parameters, below.
Example URI	http://localhost:8080/uc/resources/emailconnection?connectionname=Test4
Consumes Content-Type	n/a
Produces Content-Type	application/xml, application/json
Example Response	See Read an Email Connection: Example Response, below.
Email Connection Properties	See Email Connection Properties.

Anchor
Read an Email Connection URI Parameters
Read an Email Connection URI Parameters
Read an Email Connection: URI Parameters

...

XML Response

JSON Response

Expand

title	XML ResponseRequest

<emailConnection exportReleaseLevel="7.23.0.0" exportTable="ops_email_connection" retainSysIds="true" version="13">
    <authentication>true</authentication>
    <defaultUser>user1<authenticationType>Password</authenticationType>
    <authorized>false</authorized>
    <defaultUser>jane.doe@stonebranch.com</defaultUser>
    <description>description< /description>
    <emailAddr>jane.doe@stonebranch.com</emailAddr>
    <imap />
    <imapPort >143</imapPort>
    <imapSsl>true<>false</imapSsl>
    <imapStarttls>false</imapStarttls>
    <name>Email Connection 1</name>
    <oauthClient />
    <opswiseGroups />
    <smtp>server1<>smtp.gmail.com</smtp>
    <smtpPort>4567<>465</smtpPort>
    <smtpSsl>true</smtpSsl>
    <smtpStarttls>false</smtpStarttls>
    <sysId>62701879a6264107bb757a952bcc65cc<>3b2c5049632841189888c921f9584edf</sysId>sysId>
    <systemConnection>true<>false</systemConnection>
    <trashFolder />
    <type>Outgoing</type>
</emailConnection>

Expand

title	JSON ResponseRequest

{
    "authentication" : true,
  "authenticationType" : "defaultUserPassword":,
  "user1authorized" : false,
  "defaultUser" : "description":jane.doe@stonebranch.com",
  "description", : null,
  "emailAddr" : "jane.doe@stonebranch.com",

   "exportReleaseLevel" : "7.23.0.0",
 
  "exportTable" : "ops_email_connection",
 
  "imap" : null,
    "imapPort" : null143,

   "imapSsl" : truefalse,
 
  "imapStarttls" : nullfalse,

   "name" : "Email Connection 1",
  "oauthClient" : null,
  "opswiseGroups" : null[ ],
    "retainSysIds" : true,
    "smtp" : "server1smtp.gmail.com",
 
  "smtpPort" : 4567465,
    "smtpSsl" : true,
    "smtpStarttls" : false,
  "sysId" : "systemConnection3b2c5049632841189888c921f9584edf": true,
 
  "sysIdsystemConnection" : "62701879a6264107bb757a952bcc65cc"false,
 
  "trashFolder" : null,
    "type" : "Outgoing",
 
  "version" : 13
}

Versions Compared

Old Version 3

New Version Current

Key

Anchor
Create an Email Connection Example Request
Create an Email Connection Example Request
Create an Email Connection: Example Request

Anchor
Email Connection Properties
Email Connection Properties
Email Connection Properties

Anchor
Delete an Email Connection
Delete an Email Connection
Delete an Email Connection

Anchor
List Email Connections Example Response
List Email Connections Example Response
List Email Connections: Example Response

Anchor
Modify an Email Connection
Modify an Email Connection
Modify an Email Connection

Anchor
Read an Email Connection URI Parameters
Read an Email Connection URI Parameters
Read an Email Connection: URI Parameters

Page Comparison

Versions Compared

Old Version 3

New Version Current

Key

AnchorCreate an Email Connection Example RequestCreate an Email Connection Example RequestCreate an Email Connection: Example Request

AnchorEmail Connection PropertiesEmail Connection PropertiesEmail Connection Properties

AnchorDelete an Email ConnectionDelete an Email ConnectionDelete an Email Connection

AnchorList Email Connections Example ResponseList Email Connections Example ResponseList Email Connections: Example Response

AnchorModify an Email ConnectionModify an Email ConnectionModify an Email Connection

AnchorRead an Email Connection URI ParametersRead an Email Connection URI ParametersRead an Email Connection: URI Parameters

Anchor
Create an Email Connection Example Request
Create an Email Connection Example Request
Create an Email Connection: Example Request

Anchor
Email Connection Properties
Email Connection Properties
Email Connection Properties

Anchor
Delete an Email Connection
Delete an Email Connection
Delete an Email Connection

Anchor
List Email Connections Example Response
List Email Connections Example Response
List Email Connections: Example Response

Anchor
Modify an Email Connection
Modify an Email Connection
Modify an Email Connection

Anchor
Read an Email Connection URI Parameters
Read an Email Connection URI Parameters
Read an Email Connection: URI Parameters