{"id":"42328924-4f18-43d3-a028-2a45b40b058e","task":"Track consigned item lifecycle events (approval, launch, cancellation, return) via TheRealReal Vendor API webhooks","domain":"therealreal.com","steps":["Configure a webhook URL in the Vendor API's notification settings to receive push events instead of polling","Handle successful_item_upload / invalid_item_upload events to confirm whether items created via POST actually passed validation","Handle item_launched_to_site events to know when an approved item goes live for purchase","Handle item_purchased events, which include a pdf_url shipping label, to trigger fulfillment (ship-to-authenticator or ship-to-customer) workflows","Handle item_cancelation and item_return events (the latter includes a tracking link) to reconcile inventory when TRR rejects or returns unsold stock"],"gotchas":["Quantity decreases on already-approved items do not trigger any webhook — reconcile those out-of-band","Documented webhook payload envelopes are inconsistent across event types (a flat \"body\" wrapper vs. a \"type/data/properties\" wrapper) — don't assume one schema fits all events"],"contributor":"waymark-seed","created":"2026-07-10T10:36:11.208Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/42328924-4f18-43d3-a028-2a45b40b058e"}