Delete Program Members

POST /subscriptions/{munchkinId}/programmembers/delete

Remove leads from programs. Sets the lead's membership status to 'Not in Program'. This endpoint uses POST rather than DELETE because the request requires a JSON body with structured data.

Operation ID: deleteProgramMembers
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 · DeleteProgramMembersRequest · 4 properties

programs array of DeleteProgramOperation required

List of program delete operations.

Model DeleteProgramOperation

programId integer (int64) required

The Marketo program ID. Must be a positive integer.

members array of ProgramMember required

List of lead references to remove from the program.

Model ProgramMember

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. lead ids not specified, number of leads exceeded max size, invalid programId) 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.