Remove Leads from List

POST /subscriptions/{munchkinId}/lists/remove

Remove leads from a static list. This endpoint uses POST rather than DELETE because the request requires a JSON body with structured data.

Operation ID: removeFromList
Permissions: Read-Write Lead
Request format: application/json
Returns: ErrorResponse

Parameters

Path 1

munchkinId string required

Marketo subscription Munchkin ID

Header 3

X-Mkto-User-Token string required

Marketo API access token

X-Correlation-Id string

Arbitrary string (max 255 characters). Used to trace requests through the system via Marketo Observability Data Stream.

X-Request-Source string

Arbitrary string (max 50 characters). Used to trace the source of requests.

Request body

application/json · required · ListOperationRequest · 3 properties

listId integer (int64) required

The Marketo static list ID. Must be a positive integer.

input array of Lead required

List of lead references to add to or remove from the list.

Model Lead

leadId integer (int64) required

The Marketo lead ID.

Responses

202 Accepted – request accepted for async processing

No response body is documented for this status.

400 Bad request – validation error (e.g. leads not specified, number of leads exceeded max size, invalid listId) ErrorResponse

error_code string

Error code.

message string

Error message.

Generated example

{
  "error_code": "4000801",
  "message": "Bad request"
}

401 Unauthorized – OAuth token is invalid ErrorResponse

error_code string

Error code.

message string

Error message.

Generated example

{
  "error_code": "4000801",
  "message": "Bad request"
}

Referenced models

Generated from swagger-data-ingestion.json. Generated examples are inferred from the schema; they are illustrative and may not be valid production payloads.