Remove Leads from List¶

POST /subscriptions/{munchkinId}/lists/remove

Permissions `Read-Write Lead`

Method: POST
Path: /subscriptions/{munchkinId}/lists/remove
Tag: Lists
Operation ID: removeFromList

Remove leads from a static list. This endpoint uses POST rather than DELETE because the request requires a JSON body with structured data. Required permission: Read-Write Lead.

Formats¶

Request: application/json
Response: application/json

Request¶

Path parameters¶

Name	Type	Required	Description	Constraints
`munchkinId`	string	Yes	Marketo subscription Munchkin ID

Header parameters¶

Name	Type	Required	Description
`X-Mkto-User-Token`	string	Yes	Marketo API access token
`X-Correlation-Id`	string	No	Arbitrary string (max 255 characters). Used to trace requests through the system via Marketo Observability Data Stream.
`X-Request-Source`	string	No	Arbitrary string (max 50 characters). Used to trace the source of requests.

Request body¶

Name: requestBody
Required: Yes
Schema: model: ListOperationRequest

Generated example¶

{
  "listId": 1064,
  "input": [
    {
      "leadId": 10001
    },
    {
      "leadId": 10002
    }
  ]
}

Referenced models¶

ListOperationRequest

Example request¶

POST https://mkto-ingestion-api.adobe.io/subscriptions/{{munchkinId}}/lists/remove
X-Mkto-User-Token: {{X-Mkto-User-Token}}
X-Correlation-Id: {{X-Correlation-Id}}
X-Request-Source: {{X-Request-Source}}
Content-Type: application/json
Accept: application/json

{
  "listId": 1064,
  "input": [
    {
      "leadId": 10001
    },
    {
      "leadId": 10002
    }
  ]
}

Responses¶

202 — Accepted – request accepted for async processing¶

No response schema is defined.

Response headers¶

Name	Type	Required	Description	Constraints
`X-Request-Id`	string	No	Unique request ID

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

Schema: model: ErrorResponse

Generated example¶

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

Referenced models¶

ErrorResponse

401 — Unauthorized – OAuth token is invalid¶

Schema: model: ErrorResponse

Generated example¶

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

Referenced models¶

ErrorResponse

Source¶

Generated from swagger-data-ingestion.json.

Generated examples are inferred from the schema. They are illustrative and may not be valid production payloads.