API22% of the exam
REST errors, SOAP status and asynchronous responses
How to read what Marketing Cloud Engagement sends back: SOAP OverallStatus, per-object results, paging and faults; asynchronous SOAP callbacks and ResultItem retrieves; REST status and custom codes; and the bodies of send, journey event and contact delete responses.
Given a scenario, evaluate the significance of response handling.
~7 min read · 22 practice questions ·
What the exam expects
- Interpret SOAP OverallStatus values and per-object results, and page through MoreDataAvailable.
- Diagnose SOAP faults by type and code, and know which faults carry a Detail node.
- Configure asynchronous SOAP callbacks and recover failed rows through ResultItem.
- Map REST HTTP status and custom codes to the right action: new token, matching endpoint, Retry-After, backoff, Support or a corrected request.
- Read send, journey event and contact delete responses that look successful but aren't final.
- Key terms: OverallStatus (the request-level SOAP result); SOAP fault (an error response that means the call didn't complete); postback (an HTTP POST callback with asynchronous results); ResultItem (the retrievable result of one top-level object in an asynchronous request); custom code (the Marketing Cloud number paired with an HTTP status).
Key facts
Has Error
- Detail
- Some operations failed, some succeeded
Retrieve Error
- Detail
- First verify the Properties value
MoreDataAvailable
- Detail
- More than 2,500 records; page with ContinueRequest
Detail node
- Detail
- Server faults only
RespondWhen default
- Detail
- Never
Failed callbacks
- Detail
- Not retried
Failed async rows
- Detail
- ResultItem with ErrorCode greater than 0; OrdinalID
Retry-After
- Detail
- 429 with 50100 and 503 with 50300
408
- Detail
- Exponential backoff
Triggered send Queued
- Detail
- Accepted only; check delivery details
Journey event success
- Detail
- 201 with eventInstanceId
Sync SOAP sizing
- Detail
- 20 or fewer threads; up to 50 objects per sync call, 100 per async call
Sources for this section (10)
- Createdeveloper.salesforce.com (opens in a new tab)
- Retrievedeveloper.salesforce.com (opens in a new tab)
- ContinueRequestdeveloper.salesforce.com (opens in a new tab)
- SOAP Faultsdeveloper.salesforce.com (opens in a new tab)
- Response Optionsdeveloper.salesforce.com (opens in a new tab)
- Upsert Asynchronouslydeveloper.salesforce.com (opens in a new tab)
- Handle Errors in REST APIdeveloper.salesforce.com (opens in a new tab)
- Triggered Send Definitiondeveloper.salesforce.com (opens in a new tab)
- Fire the Eventdeveloper.salesforce.com (opens in a new tab)
- Use SOAP API in Email Studiotrailhead.salesforce.com (opens in a new tab)
- When should a REST call that returned 408 Execution Timeout Expired be retried, and how?
- How many ResultItem objects does an asynchronous request that creates three Subscribers produce?
- What does an HTTP 596 response mean?
- Why can resubmitting asynchronously resolve a RemoteDBConnDetected_SyncAPICallUnsupported fault?
The questions are free to read. Answers with their sources and self-grading are included with the pack.
Keep reading with the Marketing Cloud Engagement Developer pack
- Core concepts
- Exam traps
- Worked scenario
The pack includes:
- All 25 lessons of the Marketing Cloud Engagement Developer guide, with reading progress
- Interactive decision walks and step-by-step sequence steppers
- Practice exams purchase adds inline bank questions and topic practice (22 questions for this lesson)
- An official source cited for every claim
- An AI tutor that answers from the guide
- Choose guide-only, practice-only, or save $4 with both