Morf (Preview)

Morf is a modern and lightweight API-driven platform that offers a rapid and flexible approach to form generation.

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
Name	Morf Support
URL	https://getmorf.io/support
Email	support@getmorf.io

Connector Metadata
Publisher	AFTIA Solutions
Website	https://getmorf.io
Privacy policy	https://github.com/aftialabs/morf-docs/blob/main/guides/DataandPrivacyPolicy.md
Categories	Productivity;Sales and CRM

Morf is a lightweight API-driven platform for automatically generating forms that can easily be embedded into existing systems, apps, and sites. Morf provides a REST API that can be used to dynamically generate user interfaces and capture information to power your digital processes. Morf simplifies authoring, publishing, and deployment of web based forms allowing businesses to rapidly roll out seamlessly integrated and branded data capture solutions. IT professionals will find that unlike many SaaS forms solutions, Morf easily integrates into their development workflow.

Prerequisites

Before using this connector, you will need a Morf API Key and a form definition. Refer to the Obtaining Credentials and Getting Started sections below to get started.

Obtaining Credentials

To get started, head over to our Morf Editor and request access keys. You will be granted one (1) site and one (1) API key. As described in our authentication documentation, use the provided API key when configuring your new Power Platform connection. Our free usage terms are available here.

Getting Started

1. To get started, start by creating a Morf form definition. This can be done by using our Morf Editor and creating a new form from scratch or by converting an existing document.
2. With your form definition handy, you can now create a new Power Platform Flow leveraging the Morf Render operation.
3. Configure a new connection if one is not present by adding your Morf API key to the connection configuration.
4. Configure the action to pass your form definition and optionally data to it, and after invoking your flow you will receive a rendered Morf form.
5. This form can be sent to a user by using many different delivery mechanisms or it can be presented to a user directly using the HTTP Response action.
6. For more information on submitting a form to a Power Platform Flow, have a look at our documentation.

Known Issues and Limitations

• Free tier users may experience slower response times during periods of increased usage due to provisioning standards

Common Errors and Remedies

• Users with a misconfigured or invalid API key will receive an invalid key exception (Error Status: 401) when calling the service
• In the case of an invalid form definition, the default Power Automate retry policy may continue making calls to the render service resulting in multiple errors (Error Status: 500) until a timeout is reached. Setting the retry policy to none or to a defined maximum threshold can help avoid this behavior.

Frequently Asked Questions

How are new forms created?

This can be done by using our Morf Editor and creating new forms from scratch or by converting existing documents.

Can Morf forms be embedded?

Absolutely. Morf forms can be embedded into any web property without the use of inline frames (iframe). Get started by heading over to our Morf Editor to generate an embed tag.

What makes Morf forms different?

Morf forms use a concept called generational interfaces which allows form definitions to be dynamically modified in real-time when calling our render APIs. This allows for advanced dynamic behavior as part of render logic and operations.

How do I submit a Morf form?

Morf forms can be submitted to any API that accepts a POST request. Information on submissions can be found here.

Can Morf forms be submitted to a Power Platform Flow?

Yes! Follow this guide to set up your own submission flow.

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
API Key	securestring	The API Key for this service. Get your API key from https://getmorf.io/mspa	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Render a new Morf data capture experience (V1)	Call this API with a Morf form definition and optionally data to receive a prefilled form document that can be presented to a user in a browser context.
Transform a JSON payload using JSONata (V1)	Call this API with a JSON payload and a JSONata query or transformation expression to receive the modified data or query result.

Render a new Morf data capture experience (V1)

Operation ID:

render

Call this API with a Morf form definition and optionally data to receive a prefilled form document that can be presented to a user in a browser context.

Parameters

Name	Key	Required	Type	Description
Form Definition	form	True	string	Form definition to be rendered
Data	data		string	(Optional) Data to be used to prefill the form

Returns

Rendered Morf HTML

response

RenderResponse

Transform a JSON payload using JSONata (V1)

Operation ID:

transformJsonata

Call this API with a JSON payload and a JSONata query or transformation expression to receive the modified data or query result.

Parameters

Name	Key	Required	Type	Description
JSON Data	data	True	string	Data to be queried or transformed
JSONata Expression	expression	True	string	JSONata expression to to execute against the data. See https://jsonata.org/

Returns

A transformation response object

Response

TransformationResponse

Definitions

RenderResponse

Rendered Morf HTML

Rendered Morf HTML

Form

string

TransformationResponse

A transformation response object

Name	Path	Type	Description
Result	result	string	Result of the expression execution containing a string or a stringified object.