Partilhar via

PoliteMail

  • Reference

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
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   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)
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)
Contact
URL https://www.politemail.com
Email 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 SmartAttachment

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

Operation ID:
Lists_AddEmailsById

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

Operation ID:
Campaigns_NewCampaign

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

Operation ID:
Contacts_NewContact

This action will create a contact.

Parameters

Name Key Required Type Description
FirstName
 FirstName string
LastName
 LastName string
Email
 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

Operation ID:
Lists_NewList

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

Operation ID:
Templates_NewTemplate

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

Operation ID:
Contacts_GetContactsFromList

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

Operation ID:
Lists_RemoveEmailsById

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

Operation ID:
SentMessages_Send

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

Operation ID:
SmartAttachments_NewAttachment

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

Operation ID:
Images_NewImage

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

Operation ID:
OnNewContact

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
 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