Action: Add Lead to List

Marketo Operation

The Add Lead to List action includes a contact or lead in a specific marketing list for targeted campaigns or segmentation.

Example User Story

I want to nurture new event registrants with a welcome email series, so I’ll use Marketo’s Add Lead to List action to include them in our "New Leads - Webinar" campaign list.

Fields

Field Name	Field Type	Required
listId	Integer	Yes
leadId	Integer	Yes
accessToken	String	Yes

Related Connections

Marketo

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "add-lead-to-list",
  "state": "inDev",
  "meta": {
    "short": "Add Lead to List",
    "description": "Adds a lead to a specified list in Marketo."
  },
  "input": [
    {
      "name": "listId",
      "type": "Integer",
      "required": true,
      "meta": {
        "description": "The ID of the list to which the lead will be added."
      }
    },
    {
      "name": "leadId",
      "type": "Integer",
      "required": true,
      "meta": {
        "description": "The ID of the lead to be added to the list."
      }
    }
  ],
  "output": [
    {
      "name": "success",
      "type": "Boolean",
      "selector": ["success"],
      "meta": {
        "description": "Indicates whether the operation was successful."
      }
    },
    {
      "name": "status",
      "type": "String",
      "selector": ["status"],
      "meta": {
        "description": "The status message returned by Marketo."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/rest/v1/lists/{{listId}}/leads.json",
        "headers": {
          "Content-Type": "application/json"
        },
        "bodyTemplate": {
          "value": "{\"input\":[{\"id\":{{leadId}}}]}",
          "placeholders": [
            {
              "name": "listId",
              "type": "Integer",
              "description": "The ID of the list.",
              "required": true
            },
            {
              "name": "leadId",
              "type": "Integer",
              "description": "The ID of the lead.",
              "required": true
            },
            {
              "name": "accessToken",
              "type": "String",
              "description": "The access token for Marketo API authentication.",
              "required": true
            }
          ]
        }
      }
    }
  ]
}