DataMotion (Preview)

DataMotion, Inc. specializes in secure data exchange APIs, allowing companies to integrate secure message and file exchange solutions into their existing workflows and save development time. Following security protocol can be time-consuming, but DataMotion's connector enables seamless, one-way encrypted messaging, helping users remain compliant with industry regulations and your enterprise's security policies.

This connector is available in the following products and regions:

DataMotion, Inc. is an API company specializing in secure data transfer. This means that you can utilize our secure message delivery connector to securely send encrypted text, documents, images, files and more to any user with a valid email address. With this end-to-end encryption, you can be sure the content of your messages hasn’t been taken offline or altered in any way, whether while in transit or in your inbox. In addition to securely sending messages, the secure message delivery connector allows you to track and retract secure messages. By integrating this functionality into your workflows, your users will be able to securely automate tasks that may have been completely out of the question before, as automation may have jeopardized security. Your organization will be able to leverage Power Automate for automating a myriad of tasks, including the proper, secure handling of clinical information, transferring patient health records, transferring payment stubs, storing employee retirement plans, and more.

Prerequisites

To utilize DataMotion’s secure message delivery connector, you will first need to create a DataMotion account. You have the option to create a paid, subscription-based account, or a free 30-day trial to start. To create an account, navigate to datamotion.com/portal.

Once you have completed this step, you will automatically receive a $25 credit to test the API. From here, you can select ‘Payments’ to continue to add to your balance in the form of a one-time or recurring payment. You will need a balance in order to continue sending, tracking and retracting secure messages with the secure message delivery connector.

How to get credentials

To create a DataMotion account, navigate to datamotion.com/portal where you will see a list of API plans displayed. Hover over the ‘secure message delivery’ plan and click the ‘Try Now’ icon.

Once you have selected ‘Try Now’ you will see the ‘API – secure message delivery Self-Service Center’ page displayed. This center provides the option to test the DataMotion APIs, review documentation and contact support if needed.

In the top right corner of the screen there is a ‘Login’ button. Click this button to get started. A new pop up will display once the button is selected; at the bottom of this pop up, select ‘sign up here.’

After you have completed these steps, you will see a request for information and a section to create a password. Enter the required information and create your secure password.

Review and agree to the terms of service, then finish the process by selecting ‘Create Your Account.’ There you have it! Your account has been created and you will automatically have a $25 balance to test our APIs.

Get started with our connector

DataMotion’s secure message delivery is a perfect addition within automated workflows. The connector itself cannot be used as a trigger, but can be used to send, track and retract secure messages once your workflow is ignited.

There are a few common triggers for workflows utilizing the secure message delivery connector. A form submission is one example, as users may need to pull sensitive data from a form then send it along in a secure manner. Signing a form using the DocuSign connector will also be a common trigger. Important documents that need to be signed and passed along are often business-critical, or contain PII, PHI or PCI and therefore should be sent securely. Finally, a timed interval can be used to trigger a workflow on a daily, weekly or monthly basis. This is especially useful when important data, such as an updated customer account list or weekly profit review, needs to be encrypted and sent to a third party on a regular basis.

To get started with the secure message delivery connector, first create a new Power Automate workflow and select a trigger. You can utilize one of the examples above or a more unique trigger.

Once a trigger is selected, you will need to add the sensitive data you wish to send. For example, if you choose a form submission as a trigger, the first step in the workflow will be to collect the data from this form. Once you have gathered sensitive data through your workflow, the next step is to send the data through a secure message. In order to do this, you will need to add an additional workflow step.

To do this, select ‘+ Next Step’ and search for the DataMotion connector. You can do this by typing ‘secure message delivery’ in the search bar at the top of the new step section.

Once you have selected the ‘+ Next Step’ button, you will see a list of actions associated with this connector. Choose ‘Send Secure Message’ as the action.

A new widget will display the secure message request.

Below, I will walk through each section of the request and provide example entries. Keep in mind you may need to customize these fields to properly test (especially the ‘To’ address!).

• Version

  • V– this section is asking for the version of the DataMotion API you are using. You can find the version of the API you are using in the ‘How Do I’ section of our self-service portal. At the top of the ‘Required Parameter’ section you can find the API version.

• X-API-Secret

  • To get the API secret key, navigate back to the self service center and sign in. Once you have signed in, a new tab should appear titled ‘Applications.’ Select this tab.
    • From here, select the ‘Create Application’ button and give the application a name. Then select ‘Other’ for the Application Type and provide a description.
    • Select the ‘plus’ sign (+) in the center of the API Keys section and copy the API Secret that is provided in the pop up. Paste this key into the X-API-Secret text box in Power Automate.

• X-API-Key

  • In the API Key section, copy the key provided and paste it in the X-API-Key section in Power Automate.

• From

  • The ‘From’ address will be the address you are sending the secure message from. Enter in the address with which you created the API Secret and Key.

• To

  • The ‘To’ address can be any address with a mailbox. To test, you can enter the same address you used for the from address or any address you have access to.

• Cc (Optional)

  • Enter any additional email address that have a corresponding mailbox you would like copied.

• Bcc (Optional)

  • Enter any additional email address that have a corresponding mailbox you would like to blind copy.

• Subject (Optional)

  • Enter the subject of the email.

• Attachments (Optional)

  • To add an attachment, you will need to provide the base64 string, content type, file name and content ID. There are a few additional steps to gather this information automatically, but for the demo today, you can leave this section blank.

• HtmlBody (Optional)

  • In this section, you can add html text to send in the body of the message. For this example, you can keep this section blank.

• TextBody (Optional)

  • In this area, outline the body in plain text and add the sensitive information you would like to send.

When clicking in each of the textboxes, you may see ‘Insert parameters from previous step.’ These parameters you see suggested are the responses you may have previously pulled from either a form, Excel sheet, or another sensitive document. You can select these parameters to include this data in the body of the email.

Once you have finalized your configurations, select ‘Save.’ You will see a message confirming your workflow has been saved at the top of your screen.

Now you have created a workflow that incorporates the DataMotion secure message delivery API!

Known issues and limitations

DataMotion’s secure message delivery connector has one known limitation. If a user tries to track or retract a message directly after sending it, an error message may appear indicating the message could not be found. This is because the message ID has not yet been updated. A two-second delay or retry on failure will resolve this issue.

Common errors and remedies

An invalid API secret or key will result in a 401 error. To resolve this error you need to create a new key. Navigate to the DataMotion secure message delivery portal and select the Applications tab. In this tab you will see an API Key section with your current API key display. Delete your current API key with the trash icon located to the right of the key.

Once the trash icon is selected, the key will be removed and a new option to add a key will be available in the middle of the API Key section of the page. Select this option and securely save the secret key (that you will see displayed) as you will not be able to access this key again from the DataMotion portal. From here, copy your new API key into your Power Automate workflow.

FAQ

Where do I get an API key and secret?

To create an API key or secret, navigate to the DataMotion secure message delivery portal and select the ‘Applications’ tab. In the ‘API Key’ section, an option to add a key will be available; you will see the option in the middle of the section. Select this option and securely save the secret key that will be displayed, as you will not be able to access this key again from the DataMotion portal. From here, copy your new API key into your Power Automate workflow.

How do I sign up for a DataMotion account?

To sign up for a DataMotion account, navigate to datamotion.com/portal where you will see a list of API plans displayed. Hover over the ‘secure message delivery’ plan and click the ‘Try Now’ icon.

Once you have selected ‘Try’ you will see the ‘API – secure message delivery Self-Service Center’ page displayed. This center provides the option to test the DataMotion APIs, review documentation and contact support if needed.

In the top right corner of the screen there is a ‘Login’ button. Select this button to get started. A new pop up will display once the button is selected - at the bottom of this pop up select ‘sign up here.’

After you have completed these steps, you will see a request for information and a section to create a password. Enter the required information and create your secure password.

Review and agree to the terms of service, then finish the process by selecting ‘Create Your Account.’ There you have it! Your account has been created and you will automatically have a $25 balance to test our APIs.

How do I add to my balance?

To add to your balance, navigate to the DataMotion secure message delivery portal and select ‘Payments’ under your available balance. Provide your name, company and address then hit ‘Next.’ From here, you can set up a recurring payment that will refill automatically; you also have the option to make a one-time payment.

Throttling Limits

Actions

Retract a Secure Message

Send a Secure Message

Track a Secure Message

Definitions

SendSecureMessageResponse

TrackMessageResponse

AttachmentMetaData

Tracking

Size

AttachmentTracking

Recipient