Skip to main content
Skip table of contents

Create or change an API template

A Dynamo Task API compatible application template (DAP) can be created and tested using the Dynamo Template Builder.

If Task API has not been already enabled for your organization, send email to to request trial license.

Template Builder steps

  1. Create a new custom template by selecting “Task API” or other master template

  2. Select a main object

  3. Add content to the document template

  4. Do a test run by clicking the “Test” button (see chapter “Testing” for more info)

  5. Template logic can be configured further from the “Settings” tab

  6. Click on the “Save” button to save the template to Salesforce


If “Task API” has been selected as the master template you have two testing options:

  • Testing with UI

  • Testing with API

Testing with UI

Click the Test button in the main ribbon. If the test parameter is “test=true”, the resulting document will immediately be shown in a special test screen. The test screen is not used in real API use.

Clicking on the “Continue” button will either save the document to Salesforce, send it via email, or both, depending on template settings. Clicking on the “End” button will end the test run without any further actions.

When the test run is over, the debug view will show if it’s enabled. This is a good way to do iterative testing until the document looks as desired.

Next, testing should continue with real API to be sure that result is as expected.

Testing with API

This testing method will use real API and requires that API is enabled and org has API tasks left.


Enable “API” button from settings if it’s not already visible in the ribbon.

Settings -> Template Builder -> API -> Show API button: on


Click “API” button to see API view.


Add required parameters such as “id” with values (id is typically the Salesforce test record id)

Click on the “Send” button.

If all went well, a response code 202 will be shown, meaning that Dynamo accepted the API request.

Click on the “Refresh” button to see the API task status.

Status responses tells if the API task is ready and if any errors occurred during the process. Click on the “Refresh” button for each “Ready” message.

Check the response JSON. If the “error” property is true, it means the task produced one or more errors. See the “log” property for more info.

Using DAP outside Template Builder

When a DAP is saved to Salesforce it can be used e.g. from Salesforce flow.

Automatic variable

DAP logic can use automatic variable:


Returns current task ID.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.