Sync Program Member Status

POST /subscriptions/{munchkinId}/programmembers

Sync (upsert) program member status. Adds leads to programs or updates their program status.

Operation ID: syncProgramMembers
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 · SyncProgramMembersRequest · 5 properties

programs array of ProgramOperation required

List of program operations. Each specifies a program, a target status, and the leads to sync.

Model ProgramOperation

programId integer (int64) required

The Marketo program ID. Must be a positive integer.

status string required

The program member status to set (e.g. 'Member', 'Influenced'). Must not be 'Not in Program'; use the delete endpoint instead.

members array of ProgramMember required

List of lead references to add or update in 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. status not specified, lead ids not specified, number of leads exceeded max size, status 'Not in Program' not allowed, 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.