Partager via


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)

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)

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

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.