> ## Documentation Index
> Fetch the complete documentation index at: https://docs.refold.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Building a Marketo integration

> This tutorial will give an example of how to create a Marketo integration that adds a new company from your app to the Linked Account's Marketo.

## Pre-requisites

1. Marketo App is enabled in Refold.
2. Trigger created in Refold. Refer [here](https://docs.gocobalt.io/guides/workflow/triggers).
3. Linked Account available. Refer [here](https://docs.gocobalt.io/guides/platform/linked-account).

## Building a Workflow

#### 1. Create Workflow in app

* Go to your [`Apps catalog`](https://app.gocobalt.io/apps) in **Refold** > Search for `Marketo` > `Workflows` > `Add Workflow` > Choose `Manually` > Give it a name and click on `Add Workflow`.

<img height="200" src="https://mintcdn.com/cobalt-55/0IGKzTphHY-auv_h/images/Marketo/marketo_workflow.png?fit=max&auto=format&n=0IGKzTphHY-auv_h&q=85&s=247f3f824a9f43002ad443aec1cb2354" alt="Navigation for Workflow setup" data-path="images/Marketo/marketo_workflow.png" />

#### 2. Adding the Trigger

To add a trigger for a Workflow in Refold, you need to select details about the Trigger like the Type and which trigger to be implemented.

To add a Trigger, follow these steps:

* Click on the **Start node** to add a trigger.
* In the right side, select the **Type** and the **Trigger** and click on the `Add Trigger` button.

<img height="200" src="https://mintcdn.com/cobalt-55/0IGKzTphHY-auv_h/images/Marketo/marketo_start.png?fit=max&auto=format&n=0IGKzTphHY-auv_h&q=85&s=ddf917d2b32ea9095641c1793636d0fd" alt="Start Node Trigger" data-path="images/Marketo/marketo_start.png" />

#### 3. Adding the Marketo Action

* From `Actions`, add a Marketo node to the workflow.
* Click on the node and select an Action from the `Choose an Action` dropdown menu and click on `Save`.

<img height="200" src="https://mintcdn.com/cobalt-55/0IGKzTphHY-auv_h/images/Marketo/marketo_action.png?fit=max&auto=format&n=0IGKzTphHY-auv_h&q=85&s=d52400b70a06d7a7707349b916141d37" alt="Marketo Node" data-path="images/Marketo/marketo_action.png" />

<Warning>
  Before clicking on `Save`, make sure that you have entered data for all the mandatory fields whichever required.
</Warning>

* Connect the two nodes by clicking on `+` button on the `Start` node and dragging the arrow to the **Marketo** node.

#### 4. Publishing the Workflow

* To publish the workflow, click on the `Publish` button in the top, **Select Environments** of the Workflow and click on `Publish`.

<img height="200" src="https://mintcdn.com/cobalt-55/0IGKzTphHY-auv_h/images/Marketo/marketo_publish.png?fit=max&auto=format&n=0IGKzTphHY-auv_h&q=85&s=b9119335717af36d004825470810a5b6" alt="Publish Workflow" data-path="images/Marketo/marketo_publish.png" />

## Enabling the Workflow

To enable a workflow, end user or a Linked Account needs to Toggle On the Workflow after connecting with the application.

* Navigate to the Linked Account in which the Workflow needs to be enabled by getting its' **Hosted URL**.

<img height="200" src="https://mintcdn.com/cobalt-55/z_Cm6DgpvP5zfZT8/images/Slack/Slack_linked.png?fit=max&auto=format&n=z_Cm6DgpvP5zfZT8&q=85&s=99b8486c82e3acc53fac043de180e154" alt="Navigate to Linked Account" data-path="images/Slack/Slack_linked.png" />

* Go to the Hosted URL and select **Marketo** from `Manage your Integrations` list.
* Enter the required fields and click on `Connect`.
* After a successful connection, you can see the `Configure` section in the Marketo Application page.
* Enable the Workflow **Create a new company** by turning the **toggle On** and click on `Save`.

## Fire an App Event

Lastly, we'll fire an App Event whenever a contact is created in your app by using the Workflow.

* Navigate to `Try API` in **Refold**.
* Choose the **Linked Account** created to test the workflow, select the **Event** and Marketo as the **Application**.
* Click on the `Fire Event` button in the top right.

<img height="200" src="https://mintcdn.com/cobalt-55/0IGKzTphHY-auv_h/images/Marketo/marketo_fire.png?fit=max&auto=format&n=0IGKzTphHY-auv_h&q=85&s=8c082b93c00fb4a48004eebcb8f8e010" alt="Fire an App Event" data-path="images/Marketo/marketo_fire.png" />

* You can check the status of the event by navigating to `Logs` > `Events` in **Refold**.

Congratulations! We have successfully built a Marketo integration that adds a new company from your app to the Linked Account's Marketo.
