> For the complete documentation index, see [llms.txt](https://docs.planetcrust.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.planetcrust.com/human-connections/marketo/marketo.md).
# Marketo
Try @Human Buy @Human Subscription Join @Human Community
Put Marketo to Work with @Human Automations and @Human Agents
The Marketo Connection documents all Triggers, Actions and Query Operations available for creating automations via the Marketo API.
{% embed url="" %}
#### What can you do with the Marketo Connection?
* Connect to the Marketo API in a few clicks
* Use the related Marketo Operations (see below) in @Human Automations or @Human Agents
### Related Operations
#### Trigger Operations
**Lead Created**
Triggers on: leads/leadCreated
Triggered when a new lead is created in Marketo.
**Lead Updated**
Triggers on: leads/leadUpdated
Triggered when an existing lead is updated in Marketo.
**Activity Created**
Triggers on: activities/activityCreated
Triggered when a new activity is recorded for a lead in Marketo.
#### Action Operations
[Action: Add Lead to List](/human-connections/marketo/marketo/action-add-lead-to-list.md)
[Action: Create or Update Lead](/human-connections/marketo/marketo/action-create-or-update-lead.md)
[Action: Update Program](/human-connections/marketo/marketo/action-update-program.md)
[Action: Find Company](/human-connections/marketo/marketo/action-find-company.md)
#### Query Operations
Example link
### Related Automations
Example link
### Obtaining Access Credentials
To obtain a **Personal Access Token (PAT)** for **Marketo**, follow these steps:
#### **Prerequisites**
* **Admin access** to the Marketo instance.
* **Subscription**: Must be on a **Marketo Engage** plan with API access enabled.
#### **Steps**
1. **Log in** to your Marketo instance as an **Admin**.
2. Navigate to **Admin** (top-right gear icon).
3. Under **Integration**, select **LaunchPoint**.
4. Click **New** → **New Service**.
5. Enter a **Display Name** (e.g., "System-to-System PAT").
6. Under **Service**, select **"Custom"** (or "REST API" if available).
7. In the **API Only User** section:
* Check **"Enable API-only user"**.
* Enter a **Username** (must be unique).
8. Click **Create**.
9. After creation, click the **three-dot menu** next to the service → **View Details**.
10. Under **API Only User**, click **Generate Token**.
11. Copy the **Client ID** and **Client Secret** (these act as credentials for PAT generation).
### Configuring Webhooks
1. **Log in** to your Marketo instance.
2. Navigate to **Admin** in the top navigation bar.
3. Under **Integration**, select **Webhooks**.
4. Click **New Webhook**.
5. Provide a **Webhook Name** and enter the **URL** provided by the destination service.
6. Select the **Request Type** (e.g., **POST**).
7. Enter the **Template** payload (use **Insert Token** to add lead data attributes if needed).
8. Set the **Request Token Encoding** and **Response Type** (e.g., **JSON**).
9. Click **Create**.
10. Navigate to **Marketing Activities** and add the **Call Webhook** flow step to a **Smart Campaign** to trigger the webhook.
### Code (Apache v2.0): Service Connectivity and Metadata
```
{
"handle": "marketo-v1",
"status": "active",
"meta": {
"short": "Marketo",
"description": "Connector for interacting with Marketo's marketing automation platform.",
"icon": "marketo",
"tags": ["marketing", "automation", "crm"]
},
"service": {
"baseURL": {
"value": "https://{{subdomain}}.marketo.com/rest/v1"
},
"protocol": "https",
"contentType": "application/json",
"headers": {
"Accept": {
"value": "application/json"
}
},
"auth": {
"method": "system_to_system",
"params": {}
}
}
}
```
### Code (Apache v2.0): List of External Resources and Internal Mapping
```json
[
{
"handle": "leads",
"meta": {
"short": "Leads",
"description": "Manage and retrieve lead information from Marketo."
},
"endpoint": {
"value": "/rest/v1/leads.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the lead."
}
},
{
"name": "email",
"type": "String",
"selector": [
"result",
"email"
],
"meta": {
"description": "Email address of the lead."
}
},
{
"name": "firstName",
"type": "String",
"selector": [
"result",
"firstName"
],
"meta": {
"description": "First name of the lead."
}
},
{
"name": "lastName",
"type": "String",
"selector": [
"result",
"lastName"
],
"meta": {
"description": "Last name of the lead."
}
},
{
"name": "createdAt",
"type": "String",
"selector": [
"result",
"createdAt"
],
"meta": {
"description": "Timestamp when the lead was created."
}
},
{
"name": "updatedAt",
"type": "String",
"selector": [
"result",
"updatedAt"
],
"meta": {
"description": "Timestamp when the lead was last updated."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {
"filterType": {
"value": "{{filterType}}",
"placeholders": [
{
"name": "filterType",
"type": "String",
"description": "Type of filter to apply.",
"required": false
}
]
},
"filterValues": {
"value": "{{filterValues}}",
"placeholders": [
{
"name": "filterValues",
"type": "String",
"description": "Values to filter by.",
"required": false
}
]
}
},
"bodyTemplate": null
},
"read": {
"method": "GET",
"path": {
"value": "/{{id}}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the lead to retrieve.",
"required": true
}
]
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"create": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"email\": \"{{email}}\", \"firstName\": \"{{firstName}}\", \"lastName\": \"{{lastName}}\"}]}",
"placeholders": [
{
"name": "email",
"type": "String",
"description": "Email address of the lead.",
"required": true
},
{
"name": "firstName",
"type": "String",
"description": "First name of the lead.",
"required": false
},
{
"name": "lastName",
"type": "String",
"description": "Last name of the lead.",
"required": false
}
]
}
},
"update": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}, \"email\": \"{{email}}\", \"firstName\": \"{{firstName}}\", \"lastName\": \"{{lastName}}\"}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the lead to update.",
"required": true
},
{
"name": "email",
"type": "String",
"description": "Email address of the lead.",
"required": false
},
{
"name": "firstName",
"type": "String",
"description": "First name of the lead.",
"required": false
},
{
"name": "lastName",
"type": "String",
"description": "Last name of the lead.",
"required": false
}
]
}
},
"delete": {
"method": "POST",
"path": {
"value": "/delete.json",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the lead to delete.",
"required": true
}
]
}
}
},
"webhooks": [
{
"event": "leadCreated",
"path": "/webhooks/marketo/lead-created",
"payload": [
{
"name": "leadId",
"type": "Integer",
"selector": [
"leadId"
],
"meta": {
"description": "ID of the created lead."
}
},
{
"name": "email",
"type": "String",
"selector": [
"email"
],
"meta": {
"description": "Email address of the lead."
}
}
]
},
{
"event": "leadUpdated",
"path": "/webhooks/marketo/lead-updated",
"payload": [
{
"name": "leadId",
"type": "Integer",
"selector": [
"leadId"
],
"meta": {
"description": "ID of the updated lead."
}
},
{
"name": "email",
"type": "String",
"selector": [
"email"
],
"meta": {
"description": "Email address of the lead."
}
}
]
}
]
},
{
"handle": "activities",
"meta": {
"short": "Activities",
"description": "Retrieve and manage lead activities in Marketo."
},
"endpoint": {
"value": "/rest/v1/activities.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the activity."
}
},
{
"name": "leadId",
"type": "Integer",
"selector": [
"result",
"leadId"
],
"meta": {
"description": "ID of the lead associated with the activity."
}
},
{
"name": "activityTypeId",
"type": "Integer",
"selector": [
"result",
"activityTypeId"
],
"meta": {
"description": "Type of activity."
}
},
{
"name": "activityDate",
"type": "String",
"selector": [
"result",
"activityDate"
],
"meta": {
"description": "Date and time when the activity occurred."
}
},
{
"name": "primaryAttributeValue",
"type": "String",
"selector": [
"result",
"primaryAttributeValue"
],
"meta": {
"description": "Primary attribute value of the activity."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {
"activityTypeIds": {
"value": "{{activityTypeIds}}",
"placeholders": [
{
"name": "activityTypeIds",
"type": "String",
"description": "Comma-separated list of activity type IDs to filter by.",
"required": false
}
]
},
"nextPageToken": {
"value": "{{nextPageToken}}",
"placeholders": [
{
"name": "nextPageToken",
"type": "String",
"description": "Token for pagination.",
"required": false
}
]
}
},
"bodyTemplate": null
}
},
"webhooks": [
{
"event": "activityCreated",
"path": "/webhooks/marketo/activity-created",
"payload": [
{
"name": "activityId",
"type": "Integer",
"selector": [
"activityId"
],
"meta": {
"description": "ID of the created activity."
}
},
{
"name": "leadId",
"type": "Integer",
"selector": [
"leadId"
],
"meta": {
"description": "ID of the lead associated with the activity."
}
}
]
}
]
},
{
"handle": "campaigns",
"meta": {
"short": "Campaigns",
"description": "Manage and retrieve marketing campaigns in Marketo."
},
"endpoint": {
"value": "/rest/v1/campaigns.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the campaign."
}
},
{
"name": "name",
"type": "String",
"selector": [
"result",
"name"
],
"meta": {
"description": "Name of the campaign."
}
},
{
"name": "description",
"type": "String",
"selector": [
"result",
"description"
],
"meta": {
"description": "Description of the campaign."
}
},
{
"name": "createdAt",
"type": "String",
"selector": [
"result",
"createdAt"
],
"meta": {
"description": "Timestamp when the campaign was created."
}
},
{
"name": "updatedAt",
"type": "String",
"selector": [
"result",
"updatedAt"
],
"meta": {
"description": "Timestamp when the campaign was last updated."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"read": {
"method": "GET",
"path": {
"value": "/{{id}}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the campaign to retrieve.",
"required": true
}
]
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
}
},
"webhooks": []
},
{
"handle": "programs",
"meta": {
"short": "Programs",
"description": "Manage and retrieve programs in Marketo."
},
"endpoint": {
"value": "/rest/asset/v1/programs.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the program."
}
},
{
"name": "name",
"type": "String",
"selector": [
"result",
"name"
],
"meta": {
"description": "Name of the program."
}
},
{
"name": "createdAt",
"type": "String",
"selector": [
"result",
"createdAt"
],
"meta": {
"description": "Timestamp when the resource was created."
}
},
{
"name": "updatedAt",
"type": "String",
"selector": [
"result",
"updatedAt"
],
"meta": {
"description": "Timestamp when the resource was last updated."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"read": {
"method": "GET",
"path": {
"value": "/{{id}}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the program to retrieve.",
"required": true
}
]
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"create": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "Name of the program.",
"required": true
}
]
}
},
"update": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}, \"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the program to update.",
"required": true
},
{
"name": "name",
"type": "String",
"description": "Name of the program.",
"required": false
}
]
}
},
"delete": {
"method": "POST",
"path": {
"value": "/delete.json",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the program to delete.",
"required": true
}
]
}
}
},
"webhooks": []
},
{
"handle": "companies",
"meta": {
"short": "Companies",
"description": "Manage and retrieve companies in Marketo."
},
"endpoint": {
"value": "/rest/v1/companies.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the companie."
}
},
{
"name": "name",
"type": "String",
"selector": [
"result",
"name"
],
"meta": {
"description": "Name of the companie."
}
},
{
"name": "createdAt",
"type": "String",
"selector": [
"result",
"createdAt"
],
"meta": {
"description": "Timestamp when the resource was created."
}
},
{
"name": "updatedAt",
"type": "String",
"selector": [
"result",
"updatedAt"
],
"meta": {
"description": "Timestamp when the resource was last updated."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"read": {
"method": "GET",
"path": {
"value": "/{{id}}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the companie to retrieve.",
"required": true
}
]
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"create": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "Name of the companie.",
"required": true
}
]
}
},
"update": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}, \"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the companie to update.",
"required": true
},
{
"name": "name",
"type": "String",
"description": "Name of the companie.",
"required": false
}
]
}
},
"delete": {
"method": "POST",
"path": {
"value": "/delete.json",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the companie to delete.",
"required": true
}
]
}
}
},
"webhooks": []
},
{
"handle": "opportunities",
"meta": {
"short": "Opportunities",
"description": "Manage and retrieve opportunities in Marketo."
},
"endpoint": {
"value": "/rest/v1/opportunities.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the opportunitie."
}
},
{
"name": "name",
"type": "String",
"selector": [
"result",
"name"
],
"meta": {
"description": "Name of the opportunitie."
}
},
{
"name": "createdAt",
"type": "String",
"selector": [
"result",
"createdAt"
],
"meta": {
"description": "Timestamp when the resource was created."
}
},
{
"name": "updatedAt",
"type": "String",
"selector": [
"result",
"updatedAt"
],
"meta": {
"description": "Timestamp when the resource was last updated."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"read": {
"method": "GET",
"path": {
"value": "/{{id}}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the opportunitie to retrieve.",
"required": true
}
]
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"create": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "Name of the opportunitie.",
"required": true
}
]
}
},
"update": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}, \"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the opportunitie to update.",
"required": true
},
{
"name": "name",
"type": "String",
"description": "Name of the opportunitie.",
"required": false
}
]
}
},
"delete": {
"method": "POST",
"path": {
"value": "/delete.json",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the opportunitie to delete.",
"required": true
}
]
}
}
},
"webhooks": []
},
{
"handle": "customObjects",
"meta": {
"short": "Custom Objects",
"description": "Manage and retrieve custom objects in Marketo."
},
"endpoint": {
"value": "/rest/v1/customobjects.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the custom object."
}
},
{
"name": "name",
"type": "String",
"selector": [
"result",
"name"
],
"meta": {
"description": "Name of the custom object."
}
},
{
"name": "createdAt",
"type": "String",
"selector": [
"result",
"createdAt"
],
"meta": {
"description": "Timestamp when the resource was created."
}
},
{
"name": "updatedAt",
"type": "String",
"selector": [
"result",
"updatedAt"
],
"meta": {
"description": "Timestamp when the resource was last updated."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"read": {
"method": "GET",
"path": {
"value": "/{{id}}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the custom object to retrieve.",
"required": true
}
]
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"create": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "Name of the custom object.",
"required": true
}
]
}
},
"update": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}, \"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the custom object to update.",
"required": true
},
{
"name": "name",
"type": "String",
"description": "Name of the custom object.",
"required": false
}
]
}
},
"delete": {
"method": "POST",
"path": {
"value": "/delete.json",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the custom object to delete.",
"required": true
}
]
}
}
},
"webhooks": []
},
{
"handle": "lists",
"meta": {
"short": "Lists",
"description": "Manage and retrieve lists in Marketo."
},
"endpoint": {
"value": "/rest/v1/lists.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the list."
}
},
{
"name": "name",
"type": "String",
"selector": [
"result",
"name"
],
"meta": {
"description": "Name of the list."
}
},
{
"name": "createdAt",
"type": "String",
"selector": [
"result",
"createdAt"
],
"meta": {
"description": "Timestamp when the resource was created."
}
},
{
"name": "updatedAt",
"type": "String",
"selector": [
"result",
"updatedAt"
],
"meta": {
"description": "Timestamp when the resource was last updated."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"read": {
"method": "GET",
"path": {
"value": "/{{id}}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the list to retrieve.",
"required": true
}
]
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"create": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "Name of the list.",
"required": true
}
]
}
},
"update": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}, \"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the list to update.",
"required": true
},
{
"name": "name",
"type": "String",
"description": "Name of the list.",
"required": false
}
]
}
},
"delete": {
"method": "POST",
"path": {
"value": "/delete.json",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the list to delete.",
"required": true
}
]
}
}
},
"webhooks": []
},
{
"handle": "emails",
"meta": {
"short": "Emails",
"description": "Manage and retrieve emails in Marketo."
},
"endpoint": {
"value": "/rest/asset/v1/emails.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the email."
}
},
{
"name": "name",
"type": "String",
"selector": [
"result",
"name"
],
"meta": {
"description": "Name of the email."
}
},
{
"name": "createdAt",
"type": "String",
"selector": [
"result",
"createdAt"
],
"meta": {
"description": "Timestamp when the resource was created."
}
},
{
"name": "updatedAt",
"type": "String",
"selector": [
"result",
"updatedAt"
],
"meta": {
"description": "Timestamp when the resource was last updated."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"read": {
"method": "GET",
"path": {
"value": "/{{id}}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the email to retrieve.",
"required": true
}
]
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"create": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "Name of the email.",
"required": true
}
]
}
},
"update": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}, \"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the email to update.",
"required": true
},
{
"name": "name",
"type": "String",
"description": "Name of the email.",
"required": false
}
]
}
},
"delete": {
"method": "POST",
"path": {
"value": "/delete.json",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the email to delete.",
"required": true
}
]
}
}
},
"webhooks": []
},
{
"handle": "landingPages",
"meta": {
"short": "Landing Pages",
"description": "Manage and retrieve landing pages in Marketo."
},
"endpoint": {
"value": "/rest/asset/v1/landingPages.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the landing page."
}
},
{
"name": "name",
"type": "String",
"selector": [
"result",
"name"
],
"meta": {
"description": "Name of the landing page."
}
},
{
"name": "createdAt",
"type": "String",
"selector": [
"result",
"createdAt"
],
"meta": {
"description": "Timestamp when the resource was created."
}
},
{
"name": "updatedAt",
"type": "String",
"selector": [
"result",
"updatedAt"
],
"meta": {
"description": "Timestamp when the resource was last updated."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"read": {
"method": "GET",
"path": {
"value": "/{{id}}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the landing page to retrieve.",
"required": true
}
]
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"create": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "Name of the landing page.",
"required": true
}
]
}
},
"update": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}, \"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the landing page to update.",
"required": true
},
{
"name": "name",
"type": "String",
"description": "Name of the landing page.",
"required": false
}
]
}
},
"delete": {
"method": "POST",
"path": {
"value": "/delete.json",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the landing page to delete.",
"required": true
}
]
}
}
},
"webhooks": []
},
{
"handle": "forms",
"meta": {
"short": "Forms",
"description": "Manage and retrieve forms in Marketo."
},
"endpoint": {
"value": "/rest/asset/v1/forms.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the form."
}
},
{
"name": "name",
"type": "String",
"selector": [
"result",
"name"
],
"meta": {
"description": "Name of the form."
}
},
{
"name": "createdAt",
"type": "String",
"selector": [
"result",
"createdAt"
],
"meta": {
"description": "Timestamp when the resource was created."
}
},
{
"name": "updatedAt",
"type": "String",
"selector": [
"result",
"updatedAt"
],
"meta": {
"description": "Timestamp when the resource was last updated."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"read": {
"method": "GET",
"path": {
"value": "/{{id}}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the form to retrieve.",
"required": true
}
]
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"create": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "Name of the form.",
"required": true
}
]
}
},
"update": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}, \"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the form to update.",
"required": true
},
{
"name": "name",
"type": "String",
"description": "Name of the form.",
"required": false
}
]
}
},
"delete": {
"method": "POST",
"path": {
"value": "/delete.json",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the form to delete.",
"required": true
}
]
}
}
},
"webhooks": []
},
{
"handle": "snippets",
"meta": {
"short": "Snippets",
"description": "Manage and retrieve snippets in Marketo."
},
"endpoint": {
"value": "/rest/asset/v1/snippets.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the snippet."
}
},
{
"name": "name",
"type": "String",
"selector": [
"result",
"name"
],
"meta": {
"description": "Name of the snippet."
}
},
{
"name": "createdAt",
"type": "String",
"selector": [
"result",
"createdAt"
],
"meta": {
"description": "Timestamp when the resource was created."
}
},
{
"name": "updatedAt",
"type": "String",
"selector": [
"result",
"updatedAt"
],
"meta": {
"description": "Timestamp when the resource was last updated."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"read": {
"method": "GET",
"path": {
"value": "/{{id}}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the snippet to retrieve.",
"required": true
}
]
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"create": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "Name of the snippet.",
"required": true
}
]
}
},
"update": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}, \"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the snippet to update.",
"required": true
},
{
"name": "name",
"type": "String",
"description": "Name of the snippet.",
"required": false
}
]
}
},
"delete": {
"method": "POST",
"path": {
"value": "/delete.json",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the snippet to delete.",
"required": true
}
]
}
}
},
"webhooks": []
},
{
"handle": "tokens",
"meta": {
"short": "Tokens",
"description": "Manage and retrieve tokens in Marketo."
},
"endpoint": {
"value": "/rest/asset/v1/folder/{id}/tokens.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the token."
}
},
{
"name": "name",
"type": "String",
"selector": [
"result",
"name"
],
"meta": {
"description": "Name of the token."
}
},
{
"name": "createdAt",
"type": "String",
"selector": [
"result",
"createdAt"
],
"meta": {
"description": "Timestamp when the resource was created."
}
},
{
"name": "updatedAt",
"type": "String",
"selector": [
"result",
"updatedAt"
],
"meta": {
"description": "Timestamp when the resource was last updated."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"read": {
"method": "GET",
"path": {
"value": "/{{id}}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the token to retrieve.",
"required": true
}
]
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"create": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "Name of the token.",
"required": true
}
]
}
},
"update": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}, \"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the token to update.",
"required": true
},
{
"name": "name",
"type": "String",
"description": "Name of the token.",
"required": false
}
]
}
},
"delete": {
"method": "POST",
"path": {
"value": "/delete.json",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the token to delete.",
"required": true
}
]
}
}
},
"webhooks": []
},
{
"handle": "folders",
"meta": {
"short": "Folders",
"description": "Manage and retrieve folders in Marketo."
},
"endpoint": {
"value": "/rest/asset/v1/folders.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the folder."
}
},
{
"name": "name",
"type": "String",
"selector": [
"result",
"name"
],
"meta": {
"description": "Name of the folder."
}
},
{
"name": "createdAt",
"type": "String",
"selector": [
"result",
"createdAt"
],
"meta": {
"description": "Timestamp when the resource was created."
}
},
{
"name": "updatedAt",
"type": "String",
"selector": [
"result",
"updatedAt"
],
"meta": {
"description": "Timestamp when the resource was last updated."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"read": {
"method": "GET",
"path": {
"value": "/{{id}}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the folder to retrieve.",
"required": true
}
]
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"create": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "Name of the folder.",
"required": true
}
]
}
},
"update": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}, \"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the folder to update.",
"required": true
},
{
"name": "name",
"type": "String",
"description": "Name of the folder.",
"required": false
}
]
}
},
"delete": {
"method": "POST",
"path": {
"value": "/delete.json",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the folder to delete.",
"required": true
}
]
}
}
},
"webhooks": []
},
{
"handle": "files",
"meta": {
"short": "Files",
"description": "Manage and retrieve files in Marketo."
},
"endpoint": {
"value": "/rest/asset/v1/files.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the file."
}
},
{
"name": "name",
"type": "String",
"selector": [
"result",
"name"
],
"meta": {
"description": "Name of the file."
}
},
{
"name": "createdAt",
"type": "String",
"selector": [
"result",
"createdAt"
],
"meta": {
"description": "Timestamp when the resource was created."
}
},
{
"name": "updatedAt",
"type": "String",
"selector": [
"result",
"updatedAt"
],
"meta": {
"description": "Timestamp when the resource was last updated."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"read": {
"method": "GET",
"path": {
"value": "/{{id}}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the file to retrieve.",
"required": true
}
]
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"create": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "Name of the file.",
"required": true
}
]
}
},
"update": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}, \"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the file to update.",
"required": true
},
{
"name": "name",
"type": "String",
"description": "Name of the file.",
"required": false
}
]
}
},
"delete": {
"method": "POST",
"path": {
"value": "/delete.json",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the file to delete.",
"required": true
}
]
}
}
},
"webhooks": []
},
{
"handle": "users",
"meta": {
"short": "Users",
"description": "Manage and retrieve users in Marketo."
},
"endpoint": {
"value": "/rest/v1/users.json",
"placeholders": []
},
"fields": [
{
"name": "id",
"type": "Integer",
"selector": [
"result",
"id"
],
"meta": {
"description": "Unique identifier for the user."
}
},
{
"name": "name",
"type": "String",
"selector": [
"result",
"name"
],
"meta": {
"description": "Name of the user."
}
},
{
"name": "createdAt",
"type": "String",
"selector": [
"result",
"createdAt"
],
"meta": {
"description": "Timestamp when the resource was created."
}
},
{
"name": "updatedAt",
"type": "String",
"selector": [
"result",
"updatedAt"
],
"meta": {
"description": "Timestamp when the resource was last updated."
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "",
"placeholders": []
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"read": {
"method": "GET",
"path": {
"value": "/{{id}}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the user to retrieve.",
"required": true
}
]
},
"headers": {},
"queryParams": {},
"bodyTemplate": null
},
"create": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "Name of the user.",
"required": true
}
]
}
},
"update": {
"method": "POST",
"path": {
"value": "",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}, \"name\": \"{{name}}\"}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the user to update.",
"required": true
},
{
"name": "name",
"type": "String",
"description": "Name of the user.",
"required": false
}
]
}
},
"delete": {
"method": "POST",
"path": {
"value": "/delete.json",
"placeholders": []
},
"headers": {
"Content-Type": {
"value": "application/json",
"placeholders": []
}
},
"queryParams": {},
"bodyTemplate": {
"value": "{\"input\": [{\"id\": {{id}}}]}",
"placeholders": [
{
"name": "id",
"type": "Integer",
"description": "ID of the user to delete.",
"required": true
}
]
}
}
},
"webhooks": []
}
]
```
Try @Human Buy @Human Subscription Join @Human Community
---
# 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, and the optional `goal` query parameter:
```
GET https://docs.planetcrust.com/human-connections/marketo/marketo.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.