> For the complete documentation index, see [llms.txt](https://docs.digibee.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/industry-solutions/marketo.md).

# Marketo

O conector **Marketo** integra-se à [plataforma de automação de marketing Marketo](https://developer.adobe.com/marketo-apis/api/mapi/), permitindo que você gerencie leads, campanhas e dados de atividades em seus pipelines. Você pode criar ou atualizar leads, adicioná-los a campanhas ou listas e obter registros de atividades para auxiliar no gerenciamento automatizado de leads, execução de campanhas e geração de relatórios.

## **Parâmetros**

Configure o conector usando os parâmetros abaixo. Os campos que suportam [expressões Double Braces](/documentation/connectors-and-triggers/pt-br/double-braces/overview.md) são marcados na coluna Suporta DB.

{% tabs fullWidth="true" %}
{% tab title="General" %}

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Tipo</th><th>Suporta DB</th><th>Padrão</th></tr></thead><tbody><tr><td><strong>Alias</strong></td><td>Nome (alias) para a saída deste conector, permitindo que você faça referência a ele posteriormente no fluxo usando expressões <a href="/pages/X1jtfcnrDT3JiqQnZkHs">Double Braces</a>.</td><td>String</td><td>❌</td><td>marketo-1</td></tr><tr><td><strong>Account</strong></td><td>A <a href="/spaces/cO0A6g1dOsu8BiHYqO67/pages/fS1QLzAg8rGSSJFwtrvy">conta</a> usada pelo conector. Tipo suportado: <strong>OAuth Provider</strong>.</td><td>Account</td><td>❌</td><td></td></tr><tr><td><strong>Enhanced Marketo authentication retry</strong></td><td>Se ativado, o conector solicita um novo token de acesso, acionando uma nova tentativa para respostas HTTP 401 e erros específicos do Marketo 601 ou 602 (incluindo casos em que um HTTP 200 é retornado com <code>success: false</code>)</td><td>Boolean</td><td>❌</td><td>False</td></tr><tr><td><strong>Fail On Error</strong></td><td>Se a opção for ativada, a execução do pipeline com erro será interrompida. Caso contrário, a execução do pipeline continua, mas o resultado mostrará um valor falso para a propriedade <code>"success"</code>.</td><td>Booleano</td><td>❌</td><td></td></tr></tbody></table>

{% endtab %}

{% tab title="API" %}

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Tipo </th><th>Suporta DB</th><th>Padrão</th></tr></thead><tbody><tr><td><strong>BaseURL</strong></td><td>As APIs disponíveis para este conector.</td><td>String</td><td>✅</td><td>N/A</td></tr><tr><td><strong>Path</strong></td><td>O endpoint específico do Mailgun a ser acessado. O caminho selecionado pode determinar opções adicionais de configuração, como parâmetros de consulta. Para detalhes sobre cada endpoint, <a href="https://developer.adobe.com/marketo-apis/api/mapi/">consulte a documentação do Marketo</a>.</td><td>String</td><td>❌</td><td>N/A</td></tr><tr><td><strong>Method</strong></td><td>O método HTTP usado para a solicitação.</td><td>String</td><td>❌</td><td>N/A</td></tr></tbody></table>

{% endtab %}

{% tab title="Settings" %}

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Tipo</th><th>Suporta DB</th><th>Padrão</th></tr></thead><tbody><tr><td><strong>Connect Timeout (ms)</strong></td><td>Tempo máximo permitido para estabelecer uma conexão, em milissegundos.</td><td>Integer</td><td>❌</td><td>30000</td></tr><tr><td><strong>Read Timeout (ms)</strong></td><td>Tempo máximo permitido para ler dados, em milissegundos.</td><td>Integer</td><td>❌</td><td>30000</td></tr><tr><td><strong>Stop on Client Error</strong></td><td>Quando ativado, interrompe a execução do pipeline se ocorrer um erro HTTP 4xx.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Stop on Server Error</strong></td><td>Quando ativado, interrompe a execução do pipeline se ocorrer um erro HTTP 5xx.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Override Response Charset</strong></td><td>Quando ativado, substitui o charset retornado pelo endpoint especificado na propriedade Response Charset. Caso contrário, o charset do cabeçalho Content-Type é usado.</td><td>Boolean</td><td>❌</td><td>True</td></tr><tr><td><strong>Response Charset</strong></td><td>Define o charset a ser utilizado quando <strong>Override Response Charset</strong> estiver ativado. Padrão: UTF-8.</td><td>String</td><td>❌</td><td>UTF-8</td></tr><tr><td><strong>Advanced Settings</strong></td><td>Configurações avançadas.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Raw Mode</strong></td><td>Se ativada, a opção recebe ou passa um payload que não é JSON.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Raw Mode As Base64</strong></td><td>Quando ativada, a opção mostra o retorno como base64.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Save As Local File</strong></td><td>Quando ativada, a opção salva o retorno como um arquivo no diretório local do pipeline.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Response File Name</strong></td><td>Nome do arquivo ou caminho completo do arquivo (por exemplo, <code>tmp/processed/file.txt</code>). Este parâmetro suporta Double Braces, mas a referência a informações de conta não é permitida.</td><td>String</td><td>✅</td><td>N/A</td></tr><tr><td><strong>Allow Insecure Endpoints</strong></td><td>Quando ativada, a opção permite que chamadas a endpoints HTTPS não seguros sejam realizadas.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Enable Retries</strong></td><td>Quando ativada, a opção permite que sejam feitas novas tentativas.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Number Of Retries</strong></td><td>Número máximo de tentativas antes de desistir da chamada.</td><td>Inteiro</td><td>❌</td><td>0</td></tr><tr><td><strong>Time To Wait Between Retries</strong></td><td>Tempo máximo entre tentativas (em milissegundos).</td><td>Inteiro</td><td>❌</td><td>0</td></tr><tr><td><strong>Compress Body With GZIP</strong></td><td>Quando ativada, a opção permite que o body seja comprimido com GZIP.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Force HTTP 1.1</strong></td><td>Quando ativada, a opção força a solicitação a ser executada utilizando HTTP 1.1.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Disable Connection Pooling</strong></td><td>Quando ativada, a opção não mantém as conexões em um pool. O seu uso é recomendado para endpoints que apresentam problemas de compatibilidade quando conexões são reutilizadas.</td><td>Booleano</td><td>❌</td><td>False</td></tr><tr><td><strong>Invalidate SSL Sessions on Every Call</strong></td><td>Quando ativada, a opção invalida sessões SSL em todas as chamadas.</td><td>Booleano</td><td>❌</td><td>False</td></tr></tbody></table>
{% endtab %}

{% tab title="Documentation" %}

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Tipo </th><th>Suporta DB</th><th>Padrão</th></tr></thead><tbody><tr><td><strong>Documentation</strong></td><td>Campo opcional para descrever a configuração do conector e quaisquer regras de negócio relevantes.</td><td>String</td><td>❌</td><td>N/A</td></tr></tbody></table>

{% endtab %}
{% endtabs %}

## Gerenciamento de APIs de Ativos (Asset API)

O conector Marketo suporta o gerenciamento de ativos ao expor os serviços da API de Ativos do Marketo, especificamente Pastas (Folders) e Programas (Programs). Esses recursos são essenciais para organizar, criar e gerenciar estruturas de marketing diretamente pela plataforma.

### Pastas (Folders)

Utilizadas para gerenciar a estrutura de diretórios dentro do Marketo.

<table data-full-width="true"><thead><tr><th>Tipo de operação</th><th>Ações suportadas</th></tr></thead><tbody><tr><td>Read (GET)</td><td><ul><li>Get Folder by ID</li><li>Get Folder by Name</li><li>Get Folder Content</li><li>Browse Folders</li></ul></td></tr><tr><td>Write (POST)</td><td><ul><li>Create Folder</li><li>Update Folder</li><li>Delete Folder</li></ul></td></tr></tbody></table>

### Programas (Programs)

Programas são iniciativas de marketing específicas (como webinars ou campanhas de e-mail).

<table data-full-width="true"><thead><tr><th>Tipo de operação</th><th>Ações suportadas</th></tr></thead><tbody><tr><td>Read (GET)</td><td><ul><li>Get Program by ID/Name</li><li>List by Tag</li><li>Get Smart List by Program ID</li><li>Browse Programs.</li></ul></td></tr><tr><td>Write (POST)</td><td><ul><li>Create</li><li>Update</li><li>Clone</li><li>Delete</li><li>Approve</li><li>Unapprove</li></ul></td></tr></tbody></table>

## **Exemplos de uso**

### **Filtrar leads**

Use o conector para filtrar um ou mais leads que correspondam a um tipo de filtro específico, como e-mail.

* **Account**: [Conta do tipo OAuth provider](/documentation/developer-guide/pt-br/development-cycle/build-overview/accounts.md#tipos-de-contas) configurada com credenciais do Marketo.
* **APIs**: `https://066-ACM-164.mktorest.com`
* **Path**: `/rest/v1/leads.json`
* **Method**: `GET`
* **Query {filterType}:** `id`
* **Query {filterValues}**: `63538`

**Exemplo de resposta:**&#x20;

```json
{
  "status": 200,
  "statusMessage": "200",
  "body": {
    "requestId": "c85#199298cf93d",
    "result": [
      {
        "id": 63538,
        "firstName": "John",
        "lastName": "Smith",
        "email": "johnsmith.teste6@example.com",
        "updatedAt": "2025-09-08T13:38:47Z",
        "createdAt": "2025-09-06T01:42:01Z"
      }
    ],
    "success": true
  },
  "headers": {
    "Connection": "keep-alive",
    "Content-Length": "228",
    "Content-Type": "application/json;charset=UTF-8",
    "Date": "Mon, 08 Sep 2025 13:38:48 GMT",
    "Server": "nginx"
  }
}

```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/industry-solutions/marketo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
