PoliteMail
Measure results with powerful email metrics, including opens, read-time and click through rates plus valuable analytics to help you gain the insights you need to improve your communications.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| URL | https://www.politemail.com |
| serversupport@politemail.com |
| Connector Metadata | |
|---|---|
| Publisher | PoliteMail Software |
| Website | https://www.politemail.com/ |
| Privacy policy | https://politemail.com/politemail-technical-requirements/data-privacy-gdpr/ |
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| username | securestring | The username for this api | True |
| password | securestring | The password for this api | True |
| PoliteMail domain | string | The domain where you access PoliteMail. | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
| Frequency of trigger polls | 1 | 120 seconds |
Actions
| Add emails to a list |
This action allows you to add contacts to a PoliteMail list by email address. |
| Create a campaign |
This action will create a Campaign. |
| Create a contact |
This action will create a contact. |
| Create a list |
This action allows you to create a list. |
| Create a template |
This action allows you to create a template. |
| Get contacts from a list |
This action will retrieve all contacts from a list. |
| Remove emails from list |
This action allows you to remove contacts from a PoliteMail list by email address. |
| Send a message |
This allows you to send a tracked message using PoliteMail. |
|
Upload a Smart |
This action allows you to upload a file as a Smart Attachment. |
| Upload an image |
This action will upload an image to the PoliteMail server. |
Add emails to a list
This action allows you to add contacts to a PoliteMail list by email address.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Select List
|
id | True | integer |
key: id |
|
emails
|
emails | array of string |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
odata.metadata
|
odata.metadata | string | |
|
value
|
value | boolean |
Create a campaign
This action will create a Campaign.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Name
|
Name | True | string | |
|
Description
|
Description | string | ||
|
Select Owner
|
OwnerID | integer | ||
|
Shared
|
Shared | boolean | ||
|
Select Business
|
BusinessID | integer | ||
|
Select Region
|
RegionID | integer |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
odata.metadata
|
odata.metadata | string | |
|
value
|
value | integer |
Create a contact
This action will create a contact.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
FirstName
|
FirstName | string | ||
|
LastName
|
LastName | string | ||
|
Email
|
True | string | ||
|
Select Owner
|
OwnerID | integer | ||
|
Shared
|
Shared | boolean | ||
|
Select Business
|
BusinessID | integer | ||
|
Select Region
|
RegionID | integer |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
odata.metadata
|
odata.metadata | string | |
|
value
|
value | integer |
Create a list
This action allows you to create a list.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Name
|
Name | True | string | |
|
Description
|
Description | string | ||
|
Select Owner
|
OwnerID | integer | ||
|
Shared
|
Shared | boolean | ||
|
Select Business
|
BusinessID | integer | ||
|
Select Region
|
RegionID | integer |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
odata.metadata
|
odata.metadata | string | |
|
value
|
value | integer |
Create a template
This action allows you to create a template.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Name
|
Name | True | string | |
|
Subject
|
Subject | string | ||
|
Description
|
Description | string | ||
|
File
|
BodyBinary | True | byte | |
|
Body
|
Body | string | ||
|
Select Owner
|
OwnerID | integer | ||
|
Shared
|
Shared | boolean | ||
|
Select Business
|
BusinessID | integer | ||
|
Select Region
|
RegionID | integer |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
odata.metadata
|
odata.metadata | string | |
|
value
|
value | integer |
Get contacts from a list
This action will retrieve all contacts from a list.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Select List
|
id | True | integer |
key: id |
|
Expand
|
$expand | string |
Expands related entities inline. |
|
|
Select
|
$select | string |
Selects which properties to include in the response. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
odata.metadata
|
odata.metadata | string | |
|
value
|
value | array of Contact |
Remove emails from list
This action allows you to remove contacts from a PoliteMail list by email address.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Select List
|
id | True | integer |
key: id |
|
emails
|
emails | array of string |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
odata.metadata
|
odata.metadata | string | |
|
value
|
value | boolean |
Send a message
This allows you to send a tracked message using PoliteMail.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Select Campaign
|
Campaign | integer |
Specify the campaign this message is a part of |
|
|
To
|
To | True | string |
Specify email addresses separated by semicolons |
|
Subject
|
Subject | True | string |
Specify the subject of the mail |
|
Body
|
Body | True | string |
Specify the body of the mail |
|
From (Send as)
|
From | True | string |
First Last first.last@politemail.com |
|
CC
|
CC | string |
Specify email addresses separated by semicolons |
|
|
BCC
|
BCC | string |
Specify email addresses separated by semicolons |
|
|
Importance
|
Importance | integer |
Specify the message importance |
|
|
Sensitivity
|
Sensitivity | string |
Specify the message sensitivity |
|
|
Is HTML
|
IsHTML | boolean | ||
|
Send Mode
|
SendMode | integer |
Specify Send Mode for this message: 1-individual, 2-Anonymous, 3-Aggregate Modes |
|
|
Send Later
|
SendLater | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ (UTC format) |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
odata.metadata
|
odata.metadata | string | |
|
value
|
value | boolean |
Upload a SmartAttachment
This action allows you to upload a file as a Smart Attachment.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Name
|
Name | True | string | |
|
ContentType
|
ContentType | string | ||
|
Data
|
Data | True | byte | |
|
Select Owner
|
OwnerID | integer | ||
|
Shared
|
Shared | boolean | ||
|
Privacy
|
Privacy | integer | ||
|
Select Business
|
BusinessID | integer | ||
|
Select Region
|
RegionID | integer |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
odata.metadata
|
odata.metadata | string | |
|
value
|
value | integer |
Upload an image
This action will upload an image to the PoliteMail server.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Name
|
Name | True | string | |
|
Content Type
|
ContentType | string | ||
|
Data
|
Data | True | byte | |
|
Select Owner
|
OwnerID | integer | ||
|
Shared
|
Shared | boolean | ||
|
Privacy
|
Privacy | integer | ||
|
Select Business
|
BusinessID | integer | ||
|
Select Region
|
RegionID | integer |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
odata.metadata
|
odata.metadata | string | |
|
value
|
value | integer |
Triggers
| When there is a new contact |
Triggers when a new contact is created |
When there is a new contact
Triggers when a new contact is created
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
odata.metadata
|
odata.metadata | string | |
|
value
|
value | array of Contact |
Definitions
Contact
| Name | Path | Type | Description |
|---|---|---|---|
|
id
|
id | integer | |
|
displayName
|
displayName | string | |
|
firstName
|
firstName | string | |
|
lastName
|
lastName | string | |
|
email
|
string | ||
|
activeState
|
activeState | boolean | |
|
creationDate
|
creationDate | date-time | |
|
shared
|
shared | boolean | |
|
ownerID
|
ownerID | integer | |
|
categoryID
|
categoryID | integer | |
|
stageID
|
stageID | integer | |
|
company
|
company | string | |
|
webAddress
|
webAddress | string | |
|
title
|
title | string | |
|
fileAs
|
fileAs | string | |
|
source
|
source | integer | |
|
notes
|
notes | string | |
|
custom1
|
custom1 | string | |
|
custom2
|
custom2 | string | |
|
custom3
|
custom3 | string | |
|
custom4
|
custom4 | string | |
|
custom5
|
custom5 | string | |
|
custom6
|
custom6 | string | |
|
custom7
|
custom7 | string | |
|
custom8
|
custom8 | string | |
|
custom9
|
custom9 | string | |
|
custom10
|
custom10 | string | |
|
custom11
|
custom11 | string | |
|
custom12
|
custom12 | string | |
|
custom13
|
custom13 | string | |
|
custom14
|
custom14 | string | |
|
custom15
|
custom15 | string | |
|
custom16
|
custom16 | string | |
|
custom17
|
custom17 | string | |
|
custom18
|
custom18 | string | |
|
custom19
|
custom19 | string | |
|
custom20
|
custom20 | string | |
|
businessID
|
businessID | integer | |
|
regionID
|
regionID | integer | |
|
lastChangedDate
|
lastChangedDate | date-time |