Event catalogue

This page is generated from the catalogue GET /api/v1/webhooks/events serves. It cannot describe an event that does not exist, and it goes stale only if the catalogue does.

The chapter that explains how to subscribe, verify the signature and read the delivery log is here.

The envelope

Every event arrives with the same body. The fields below are the envelope; data is what changes per event, and it arrives only when the subscription asked for it and its owner may read it.

Notice or data

Every delivery carries exactly one of data or data_omitted. These are the two modes and every reason data can be missing:

The headers

The signature

hmac-sha256, t=<unix>,v1=<hex>.

Replay window: 300 seconds. A signature older than that is rejected.

Verifying, in pseudocode

const [ts, sig] = parseHeader('X-Webhook-Signature');  // 't=…,v1=…'
const expected = hmac_sha256(secret, ts + '.' + rawBody);  // hex
if (!timing_safe_equal(sig.v1, expected)) reject(401);
if (Math.abs(now_unix() - ts) > 300) reject(401);  // 5-min replay window

Retries

Up to 5 attempts with exponential backoff: 5, 10, 20, 40, 80 seconds apart.

All retries reuse the same X-Webhook-Event-Id so your endpoint can be idempotent.

Auto-pause

A subscription pauses itself when 20 deliveries in a row exhaust their retries, or when it has been failing for 24 hours without a single successful response.

A subscription is paused when 20 events in a row exhaust their retries, or when it has failed for 24 hours without a single success. The workspace admins are notified once. A paused subscription receives nothing until POST /webhooks/{id}/resume; events in between are not queued — read the resources to catch up, or redeliver from the delivery log.

The events

156 events. The name is what goes in events when you create the subscription, and what arrives in X-Webhook-Event.

• campaign.sent
• campaign.paused
• sending_domain.verified
• coach.proposals_ready
• coach.finding_ready
• voice.autonomous_call
• safety_hold.placed
• safety_hold.ack_overdue
• safety_hold.first_response_overdue
• chileautos.lead
• yapo.lead
• website.lead
• consignment.candidate.created
• quote.issued
• quote.voided
• quote.extended
• quote.archived
• reservation.created
• reservation.voided
• reservation.abono_disposed
• reservation.converted
• sale_note.issued
• sale_note.approved
• sale_note.voided
• purchase_note.issued
• purchase_note.corrected
• purchase_note.voided
• payment.recorded
• consignment.created
• consignment.returned
• consignment.sold
• credit_application.recorded
• credit_application.submitted
• credit_application.decided
• credit_application.withdrawn
• price_approval.requested
• price_approval.decided
• conversation.created
• conversation.assigned
• conversation.resolved
• message.received
• message.sent
• ticket.opened
• ticket.reopened
• ticket.resolved
• ticket.closed
• sla.breached
• agent_scenario_run.completed
• agent_scenario_suite.completed
• ai_agent.publish
• ai_agent_graph.publish
• cost.budget_alert
• runtime.budget_exceeded
• kb.source.create
• kb.source.embed
• kb.source.update
• kb.source.delete
• kb_file.uploaded
• kb_file.deleted
• skill.created
• skill.updated
• skill.deleted
• custom_tool.created
• custom_tool.updated
• custom_tool.deleted
• lead.created
• lead.stage_changed
• lead.pipeline_changed
• lead.assigned
• lead.won
• lead.lost
• lead.unqualified
• macro.applied
• stock.source_retired
• stock.synced
• vehicle.published
• vehicle.unpublished
• vehicle.publish_failed
• vehicle.created
• vehicle.attachment.created
• mercadolibre.order
• mercadolibre.vis_lead
• appointment.booked
• appointment.rescheduled
• appointment.cancelled
• appointment.completed
• appointment.no_show
• appointment.reminded
• appointment.imported
• contact.created
• contact.updated
• contact.merged
• team.created
• team.updated
• team.deleted
• custom_role.created
• custom_role.updated
• custom_role.deleted
• macro.created
• clinic_professional.created
• clinic_professional.updated
• clinic_professional.deleted
• clinic_service.created
• macro.updated
• macro.deleted
• assignment_rule.created
• assignment_rule.updated
• assignment_rule.deleted
• sla_policy.created
• sla_policy.updated
• sla_policy.deleted
• automation_trigger.created
• automation_trigger.updated
• automation_trigger.deleted
• sending_domain.created
• sending_domain.deleted
• whatsapp_template.created
• whatsapp_template.status_changed
• whatsapp_template.deleted
• whatsapp_flow.created
• whatsapp_flow.published
• whatsapp_flow.deprecated
• whatsapp_flow.deleted
• channel.connected
• channel.updated
• channel.disconnected
• membership.created
• membership.updated
• membership.removed
• clinic_service.updated
• clinic_service.deleted
• clinic_price_list.updated
• clinic_pack_purchase.created
• clinic_pack_purchase.session_consumed
• clinic_pack_purchase.cancelled
• clinic_budget.created
• clinic_budget.sent
• clinic_budget.accepted
• clinic_budget.rejected
• clinic_budget.voided
• clinic_budget.mirror_changed
• clinic_cash_session.opened
• clinic_cash_session.closed
• clinic_patient.created
• clinic_patient.updated
• clinic_patient.deleted
• clinic_patient.merged
• clinic_encounter.opened
• clinic_encounter.closed
• clinic_note.signed
• clinic_note.amended
• clinic_consent.signed
• clinic_consent.revoked
• clinic_document.uploaded
• clinic_document.deleted
• clinic_privacy_request.completed

campaign.sent

A campaign finished sending — every recipient reached a terminal pre-delivery state (sent/failed/suppressed).

Version 1 · Resource campaign · data requires campaigns:read

Fires when. The campaign worker drains the last pending recipient and flips the campaign to status=sent.

{
  "campaign_id": "0d9b2a4e-1f6c-4e7a-9b3d-5c8e2f1a6b4d",
  "name": "Reactivación de clientes abril",
  "channel": "whatsapp",
  "total_recipients": 1240,
  "sent": 1198,
  "failed": 17,
  "suppressed": 25,
  "finished_at": "2026-06-11T15:04:05Z"
}

campaign.paused

A sending campaign was paused automatically — the WhatsApp number hit its Meta messaging limit, or the email reputation guard tripped (ADR 0032: >8% hard bounces or >0.3% complaints after 200 sends; also blocks the tenant email channel).

Version 1 · Resource campaign · data requires campaigns:read

Fires when. A campaign send gets a rate/messaging-limit error from Atribu/Meta (auto-probes hourly), or the SES event ingest crosses a reputation threshold.

{
  "campaign_id": "0d9b2a4e-1f6c-4e7a-9b3d-5c8e2f1a6b4d",
  "name": "Reactivación de clientes abril",
  "reason": "messaging_limit"
}

sending_domain.verified

A tenant email sending domain finished DKIM verification and can now send email campaigns (ADR 0032).

Version 1 · Resource sending_domain · data requires messaging_accounts:read

Fires when. A sending-domain refresh observes SES flip VerifiedForSendingStatus to true for the first time.

{
  "id": "7f2c1b9e-3a5d-4c8e-9f1a-2b6d4e8c0a3f",
  "domain": "mail.cliente.cl"
}

coach.proposals_ready

Conversation Coach generated new improvement proposals for an agent — route to Slack/email/etc. to alert the agent owner.

Version 1 · Resource ai_agent · data requires ai_agents:read

Fires when. A finding investigation or a correction synthesis persisted at least one improvement_proposal.

{
  "ai_agent_id": "4ce54eaf-…",
  "finding_id": "00000000-…-0000000f1nd1",
  "source": "investigation",
  "proposals": 3
}

coach.finding_ready

The conversation reviewer detected a RECURRING issue with an agent (Mejoras, ADR 0095) — «promete descuentos que no existen», with an occurrence count — one step before anybody proposes a fix for it.

Version 1 · Resource ai_agent · data requires ai_agents:read

Fires when. A conversation review created or bumped a finding.

{
  "ai_agent_id": "4ce54eaf-…",
  "findings": [
    {
      "id": "00000000-…-0000000f1nd1",
      "kind": "missing_knowledge",
      "topic_key": "financiamiento.pie_minimo",
      "title": "No sabe responder por el pie mínimo",
      "occurrence_count": 7,
      "status": "open"
    }
  ],
  "source": "review"
}

voice.autonomous_call

A proactive/autonomous voice agent initiated an outbound speed-to-lead call on its own (ADR-0016) — route to Slack/email so a human is aware ("warn and be careful").

Version 1 · Resource lead · data requires leads:read

Fires when. A new lead arrives and the tenant's voice agent autonomy_level is proactive or autonomous and all guardrails pass.

{
  "lead_id": "4ce54eaf-…",
  "contact_id": "00000000-…",
  "agent_id": "a1b2…",
  "autonomy_level": "proactive"
}

safety_hold.placed

A clinical SAFETY HOLD was placed on a contact: proactive messaging to that person is blocked until a named human acknowledges and resolves it. Opt-in per tenant (clinical_safety.operational_alert_webhook).

Version 1 · Resource outbound_hold · data requires outbound_holds:read

Dato sensible (health data): always delivered as the notice, without data, whatever the subscription asked for.

Fires when. The service-lifecycle evaluator decides a patient reply requires professional attention, or an operator places a hold by hand. Fires once per hold — a re-raised concern deduplicates onto the live hold.

{
  "hold_id": "018f…",
  "contact_id": "9a1c…",
  "scope": "contact",
  "kind": "safety",
  "reason": "the patient reports worsening swelling",
  "placed_at": "2027-02-09T14:03:11.000Z",
  "stepKey": "check_in_24h",
  "ticketId": "T-1247",
  "ackMinutes": 15
}

safety_hold.ack_overdue

Nobody acknowledged a safety hold within the tenant's acknowledgement target (D6 default: 15 minutes of declared coverage). The backup has been paged.

Version 1 · Resource outbound_hold · data requires outbound_holds:read

Dato sensible (health data): always delivered as the notice, without data, whatever the subscription asked for.

Fires when. The safety-hold SLA sweep (5-min tick) finds a hold still in active past its ack target. Fires once per hold.

{
  "hold_id": "018f…",
  "contact_id": "9a1c…",
  "eventType": "ack_overdue",
  "targetMinutes": 15,
  "elapsedMinutes": 22,
  "withinCoverage": true
}

safety_hold.first_response_overdue

No human wrote to the patient within the first-response target (D6 default: 60 minutes of declared coverage) after a safety hold was placed. A durable breach row was recorded.

Version 1 · Resource outbound_hold · data requires outbound_holds:read

Dato sensible (health data): always delivered as the notice, without data, whatever the subscription asked for.

Fires when. The safety-hold SLA sweep finds no human outbound message to the contact dated after the hold was placed, past the first-response target. Fires once per hold.

{
  "hold_id": "018f…",
  "contact_id": "9a1c…",
  "eventType": "first_response_overdue",
  "targetMinutes": 60,
  "elapsedMinutes": 74,
  "withinCoverage": true
}

chileautos.lead

A buyer lead arrived from Chileautos ("envío de leads") and was ingested as a Vitrina lead.

Version 1 · Resource lead · data requires leads:read

Fires when. The Chileautos leads webhook (POST /integrations/chileautos/leads) is processed by the worker.

{
  "lead_id": "7c1f0e2a-6b3d-4a9e-8f12-2b9a1c0d4e5f",
  "contact_id": "4821",
  "vehicle_id": "a35d4ff0-8612-4ff0-8612-a8ee57f4f095",
  "source": "chileautos",
  "chileautos_lead_identifier": "88d404ca-a35d-4ff0-8612-a8ee57f4f095",
  "chileautos_status": "New"
}

yapo.lead

A buyer lead arrived from Yapo.cl and was ingested as a Vitrina lead.

Version 1 · Resource lead · data requires leads:read

Fires when. The per-account yapo leads webhook (POST /integrations/yapo/leads/:accountId/:token) is processed by the worker.

{
  "lead_id": "7c1f0e2a-6b3d-4a9e-8f12-2b9a1c0d4e5f",
  "contact_id": "4821",
  "vehicle_id": "a35d4ff0-8612-4ff0-8612-a8ee57f4f095",
  "yapo_lead_id": "90815723",
  "yapo_ad_id": "75481920"
}

website.lead

A buyer inquiry arrived through a dealer website's "Consulta del sitio" form and was ingested as a Vitrina lead.

Version 1 · Resource lead · data requires leads:read

Fires when. POST /api/v1/website-leads (Bearer api_key, scope leads:intake) is processed.

{
  "lead_id": "7c1f0e2a-6b3d-4a9e-8f12-2b9a1c0d4e5f",
  "contact_id": "4821",
  "conversation_id": "9b1e2a4e-1f6c-4e7a-9b3d-5c8e2f1a6b4d",
  "vehicle_id": "a35d4ff0-8612-4ff0-8612-a8ee57f4f095",
  "submission_id": "3f7a1c9e2b4d5f6a7b8c9d0e1f2a3b4c",
  "intent": "sell"
}

consignment.candidate.created

A private owner offered their car through a dealer website's "vende tu auto" form and the submission landed as a consignment candidate.

Version 1 · Resource consignment_candidate · data requires consignments:read

Fires when. POST /api/v1/widget/consignments (publishable pk_ key, origin-locked, scope leads:intake) is processed. A honeypot-tripped or duplicate submission fires nothing.

{
  "candidate_id": "d41f2b8e-5a17-4c93-8b0e-6f1a2c3d4e5f",
  "patente": "KXTR52",
  "make": "Toyota",
  "model": "Yaris",
  "year": 2019,
  "kilometers": 68000,
  "expected_price_clp": 9500000,
  "sale_horizon": "15d",
  "region_code": "13",
  "photo_count": 3,
  "submission_id": "8b1c0a5d7e2f4a6b9c3d0e1f2a3b4c5d"
}

quote.issued

A cotización was issued — a price offer on a unit, frozen at issuance and holding no reservation on the car.

Version 1 · Resource quote · data requires quotes:read

Fires when. POST /api/v1/quotes.

{
  "id": "d2d2d2d2-0000-4000-8000-000000000001",
  "display_id": "Q-47",
  "vehicle_id": "e1e1e1e1-0000-4000-8000-000000000001",
  "buyer_contact_id": "22222222-0000-4000-8000-000000000002",
  "salesperson_id": "11111111-0000-4000-8000-000000000001",
  "offered_price_clp": 11900000,
  "tax_treatment": "afecto",
  "expires_on": "2026-09-23",
  "state": "vigente"
}

quote.voided

A cotización was voided. Terminal — a voided quote is never restored.

Version 1 · Resource quote · data requires quotes:read

Fires when. POST /api/v1/quotes/{id}/void.

{
  "id": "d2d2d2d2-0000-4000-8000-000000000002",
  "display_id": "Q-52",
  "void_reason": "el cliente desistió de la compra",
  "voided_by": "11111111-0000-4000-8000-000000000001",
  "voided_at": "2026-09-15T11:20:03.000Z"
}

quote.extended

A cotización’s validity window was moved to a new date, including bringing an expired one back to vigente.

Version 1 · Resource quote · data requires quotes:read

Fires when. POST /api/v1/quotes/{id}/extend.

{
  "id": "d2d2d2d2-0000-4000-8000-000000000001",
  "display_id": "Q-47",
  "expires_on": "2026-10-20",
  "extend_reason": "el cliente sigue esperando la aprobación del crédito",
  "extended_by": "11111111-0000-4000-8000-000000000001",
  "extended_at": "2026-09-20T09:11:44.000Z"
}

quote.archived

A cotización was filed away from the working register. Not a delete and not a state — its folio and state are unchanged.

Version 1 · Resource quote · data requires quotes:read

Fires when. POST /api/v1/quotes/{id}/archive.

{
  "id": "d2d2d2d2-0000-4000-8000-000000000003",
  "display_id": "Q-31",
  "archive_reason": "cotización antigua, ya no vigente en el seguimiento",
  "archived_by": "11111111-0000-4000-8000-000000000001",
  "archived_at": "2026-09-10T08:00:00.000Z"
}

reservation.created

A reserva took a hold on a unit — the only Wave 2a document that locks inventory.

Version 1 · Resource reservation · data requires reservations:read

Fires when. POST /api/v1/reservations.

{
  "id": "d3d3d3d3-0000-4000-8000-000000000001",
  "display_id": "R-18",
  "vehicle_id": "e1e1e1e1-0000-4000-8000-000000000001",
  "holder_contact_id": "22222222-0000-4000-8000-000000000002",
  "salesperson_id": "11111111-0000-4000-8000-000000000001",
  "agreed_price_clp": 11900000,
  "hold_expires_on": "2026-09-25",
  "status": "activa"
}

reservation.voided

A reserva was voided, releasing the hold on the unit for good.

Version 1 · Resource reservation · data requires reservations:read

Fires when. POST /api/v1/reservations/{id}/void.

{
  "id": "d3d3d3d3-0000-4000-8000-000000000002",
  "display_id": "R-22",
  "void_reason": "el cliente no completó el pago del abono a tiempo",
  "voided_by": "11111111-0000-4000-8000-000000000001",
  "voided_at": "2026-09-20T10:05:00.000Z"
}

reservation.abono_disposed

The deposit on a closed reserva was disposed of — kept, refunded or applied.

Version 1 · Resource reservation · data requires reservations:read

Fires when. POST /api/v1/reservations/{id}/abono-disposition.

{
  "id": "d3d3d3d3-0000-4000-8000-000000000001",
  "display_id": "R-18",
  "abono_disposition": "devuelto",
  "abono_disposition_reason": "el cliente desistió; se devolvió el abono",
  "abono_disposition_by": "11111111-0000-4000-8000-000000000001",
  "abono_disposition_at": "2026-09-21T09:00:00.000Z"
}

reservation.converted

A reserva was converted into a nota de venta, closing the hold and carrying its payments onto the new document.

Version 1 · Resource reservation · data requires reservations:read

Fires when. POST /api/v1/reservations/{id}/convert.

{
  "id": "d3d3d3d3-0000-4000-8000-000000000001",
  "display_id": "R-18",
  "sale_note_id": "d4d4d4d4-0000-4000-8000-000000000001",
  "sale_note_display_id": "V-118"
}

sale_note.issued

A nota de venta was issued, allocating its folio.

Version 1 · Resource sale_note · data requires sale_notes:read

Fires when. POST /api/v1/sale-notes.

{
  "id": "d4d4d4d4-0000-4000-8000-000000000001",
  "display_id": "V-118",
  "vehicle_id": "e1e1e1e1-0000-4000-8000-000000000002",
  "buyer_contact_id": "22222222-0000-4000-8000-000000000002",
  "net_clp": 11900000,
  "tax_clp": 1900000,
  "tax_treatment": "afecto",
  "status": "issued"
}

sale_note.approved

A nota de venta was approved — the instant it becomes legally valid, the car is marked sold and its deal closes won.

Version 1 · Resource sale_note · data requires sale_notes:read

Fires when. POST /api/v1/sale-notes/{id}/approve.

{
  "id": "d4d4d4d4-0000-4000-8000-000000000001",
  "display_id": "V-118",
  "approved_by": "11111111-0000-4000-8000-000000000001",
  "approved_at": "2026-09-19T14:10:00.000Z"
}

sale_note.voided

A nota de venta was voided.

Version 1 · Resource sale_note · data requires sale_notes:read

Fires when. POST /api/v1/sale-notes/{id}/void.

{
  "id": "d4d4d4d4-0000-4000-8000-000000000001",
  "display_id": "V-118",
  "void_reason": "el banco rechazó el financiamiento del comprador",
  "voided_by": "11111111-0000-4000-8000-000000000001",
  "voided_at": "2026-09-20T09:00:00.000Z"
}

purchase_note.issued

A nota de compra was issued — the instrument that creates a vehicle’s cost basis.

Version 1 · Resource purchase_note · data requires purchase_notes:read

Fires when. POST /api/v1/purchase-notes.

{
  "id": "d5d5d5d5-0000-4000-8000-000000000001",
  "display_id": "P-9",
  "seller_contact_id": "22222222-0000-4000-8000-000000000003",
  "net_clp": 6200000,
  "tax_treatment": "no_gravado",
  "status": "issued"
}

purchase_note.corrected

A live nota de compra was corrected, stamped with who changed it.

Version 1 · Resource purchase_note · data requires purchase_notes:read

Fires when. PATCH /api/v1/purchase-notes/{id}.

{
  "id": "d5d5d5d5-0000-4000-8000-000000000001",
  "display_id": "P-9",
  "corrected_by": "11111111-0000-4000-8000-000000000001",
  "corrected_at": "2026-09-13T09:00:00.000Z"
}

purchase_note.voided

A nota de compra was voided.

Version 1 · Resource purchase_note · data requires purchase_notes:read

Fires when. POST /api/v1/purchase-notes/{id}/void.

{
  "id": "d5d5d5d5-0000-4000-8000-000000000001",
  "display_id": "P-9",
  "void_reason": "se anuló la compra: el vendedor desistió antes de firmar",
  "voided_by": "11111111-0000-4000-8000-000000000001",
  "voided_at": "2026-09-14T11:30:00.000Z"
}

payment.recorded

A payment was recorded against a reservation or a nota de venta.

Version 1 · Resource document_payment · data requires document_payments:read

Fires when. POST /api/v1/document-payments (deprecated door) or POST /api/v1/payments.

{
  "id": "d6d6d6d6-0000-4000-8000-000000000001",
  "reservation_id": "d3d3d3d3-0000-4000-8000-000000000001",
  "sale_note_id": null,
  "instrument": "transferencia",
  "amount_clp": 300000,
  "paid_on": "2026-09-18"
}

consignment.created

A consignment contract was created — the vehicle’s tenencia becomes consignacion.

Version 1 · Resource consignment_contract · data requires consignments:read

Fires when. POST /api/v1/consignments or POST /api/v1/consignments/bulk.

{
  "id": "d7d7d7d7-0000-4000-8000-000000000001",
  "vehicle_id": "e1e1e1e1-0000-4000-8000-000000000001",
  "dueno_contact_id": "22222222-0000-4000-8000-000000000004",
  "modalidad": "en_local",
  "comision_type": "percentage",
  "comision_value": 10,
  "minimo_clp": 8000000,
  "estado": "activo"
}

consignment.returned

A consignment contract was returned — the car goes back to its owner and its tenencia becomes propio.

Version 1 · Resource consignment_contract · data requires consignments:read

Fires when. POST /api/v1/consignments/{id}/return or PATCH .../{id} with estado: "devuelto".

{
  "id": "d7d7d7d7-0000-4000-8000-000000000001",
  "vehicle_id": "e1e1e1e1-0000-4000-8000-000000000001",
  "estado": "devuelto"
}

consignment.sold

A consigned car was sold and settled with its owner — the contract moves to vendido and produces a Liquidación.

Version 1 · Resource consignment_contract · data requires consignments:read

Fires when. POST /api/v1/consignments/{id}/sell.

{
  "id": "d7d7d7d7-0000-4000-8000-000000000001",
  "vehicle_id": "e1e1e1e1-0000-4000-8000-000000000001",
  "liquidacion_id": "d8d8d8d8-0000-4000-8000-000000000001",
  "amount_venta_clp": 8900000,
  "comision_amount_clp": 890000,
  "monto_owner_clp": 8010000
}

credit_application.recorded

A credit application dossier was recorded.

Version 1 · Resource credit_application · data requires credit_applications:read

Fires when. POST /api/v1/credit-applications.

{
  "id": "d9d9d9d9-0000-4000-8000-000000000001",
  "display_id": "F-12",
  "vehicle_id": "e1e1e1e1-0000-4000-8000-000000000001",
  "buyer_contact_id": "22222222-0000-4000-8000-000000000002",
  "institution_id": "dadadada-0000-4000-8000-000000000001",
  "requested_amount_clp": 9500000,
  "state": "recorded"
}

credit_application.submitted

A credit application’s carpeta was recorded as sent to the lender.

Version 1 · Resource credit_application · data requires credit_applications:read

Fires when. POST /api/v1/credit-applications/{id}/submission.

{
  "id": "d9d9d9d9-0000-4000-8000-000000000001",
  "display_id": "F-12",
  "submitted_by": "11111111-0000-4000-8000-000000000001",
  "submitted_at": "2026-09-10T14:00:00.000Z"
}

credit_application.decided

The lender’s verdict was recorded on a credit application.

Version 1 · Resource credit_application · data requires credit_applications:read

Fires when. POST /api/v1/credit-applications/{id}/decision.

{
  "id": "d9d9d9d9-0000-4000-8000-000000000001",
  "display_id": "F-12",
  "outcome": "approved",
  "approved_amount_clp": 9200000,
  "decided_by": "11111111-0000-4000-8000-000000000001",
  "decided_at": "2026-09-16T10:00:00.000Z"
}

credit_application.withdrawn

A credit application was pulled by the dealership — terminal.

Version 1 · Resource credit_application · data requires credit_applications:read

Fires when. POST /api/v1/credit-applications/{id}/withdrawal.

{
  "id": "d9d9d9d9-0000-4000-8000-000000000001",
  "display_id": "F-12",
  "withdrawn_reason": "el cliente obtuvo mejores condiciones en otra financiera",
  "withdrawn_by": "11111111-0000-4000-8000-000000000001",
  "withdrawn_at": "2026-09-18T09:00:00.000Z"
}

price_approval.requested

Authority over a below-reference price was requested on a quote, a reservation or a nota de venta.

Version 1 · Resource price_approval · data requires price_approval:read

Fires when. POST /api/v1/price-approvals.

{
  "id": "dbdbdbdb-0000-4000-8000-000000000001",
  "quote_id": null,
  "reservation_id": null,
  "sale_note_id": "d4d4d4d4-0000-4000-8000-000000000001",
  "requested_price_clp": 10900000,
  "requester_user_id": "11111111-0000-4000-8000-000000000002",
  "status": "pending"
}

price_approval.decided

A price approval request was granted or rejected. Terminal — no second decision.

Version 1 · Resource price_approval · data requires price_approval:read

Fires when. POST /api/v1/price-approvals/{id}/decision.

{
  "id": "dbdbdbdb-0000-4000-8000-000000000001",
  "status": "approved",
  "decision_note": "autorizado por gerencia dado el tiempo en stock",
  "decider_user_id": "11111111-0000-4000-8000-000000000001",
  "decided_at": "2026-09-19T16:05:00.000Z"
}

conversation.created

A new conversation was opened — a customer wrote in on a channel, or the workspace opened the thread from its side.

Version 1 · Resource conversation · data requires conversations:read

Fires when. The first inbound message of a thread (any channel), POST /conversations, or a proactive outbound conversation (ADR 0108). NOT on a historical backfill: importing a dealer’s past threads is inert by design, so a coexistence or history sync fires nothing.

{
  "conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "display_id": "C-3052",
  "channel": "whatsapp",
  "contact_id": "22222222-0000-4000-8000-000000000001",
  "messaging_account_id": "16161616-0000-4000-8000-000000000001",
  "ticket_id": null,
  "handler": "bot",
  "status": "open",
  "source": null,
  "created_at": "2026-09-22T11:06:33.744Z"
}

conversation.assigned

A conversation changed hands: a new assignee, a new handler, or both.

Version 1 · Resource conversation · data requires conversations:read

Fires when. POST /conversations/:id/assign, /claim, /handoff or /return-to-ai, the assignment rules routing an unowned inbound, and a ticket assignment mirroring onto its conversation. NOT on a no-op (the same assignee and the same handler).

{
  "conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "display_id": "C-3052",
  "from_assignee_user_id": null,
  "to_assignee_user_id": "11111111-0000-4000-8000-000000000001",
  "from_handler": "bot",
  "to_handler": "human",
  "ticket_id": "dddddddd-0000-4000-8000-000000000001"
}

conversation.resolved

A conversation stopped being open work. changes.status.to is resolved (dealt with, reopened by the next inbound message) or closed (terminal).

Version 1 · Resource conversation · data requires conversations:read

Fires when. POST /conversations/:id/resolve, POST /conversations/:id/close on a thread that was not already resolved, and the auto-resolve worker. The auto-CLOSE of an already-resolved thread fires nothing: the conclusion was already reported, and reporting the grace window as a second conclusion is the two-events-for-one-action mistake. A ticket.resolved / ticket.closed follows only when no sibling conversation on that ticket is still active.

{
  "conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "display_id": "C-3052",
  "from_status": "open",
  "to_status": "resolved",
  "resolved_by": "human",
  "resolved_at": "2026-09-22T11:15:06.653Z",
  "ticket_id": "dddddddd-0000-4000-8000-000000000001"
}

message.received

The customer sent a message.

Version 1 · Resource message · data requires conversations:read

Fires when. A customer message is persisted on any channel. NOT on a history backfill (a coexistence or Instagram history sync writes customer messages with the fan-out switched off, so importing months of threads does not replay months of events), and not for the internal system lines the thread carries for assignments and status changes.

{
  "message_id": "eeeeeeee-0000-4000-8000-000000000001",
  "conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "contact_id": "22222222-0000-4000-8000-000000000001",
  "channel": "whatsapp",
  "type": "text",
  "content": "¿Me pueden confirmar la hora del jueves?",
  "external_message_id": "wamid.HBgLNTY5NzcwMDAwMjE",
  "created_at": "2026-09-22T11:07:02.824Z"
}

message.sent

The workspace sent a message to the customer. The envelope’s author says who wrote it: a member, a member through a connected app or a personal token, an API key, or the AI agent.

Version 1 · Resource message · data requires conversations:read

Fires when. An outbound message is persisted — the AI answering, a teammate replying, an API send, a template, a flow, a location pin, an attachment or a voice note. It fires at PERSIST, which on most channels is the moment Vitrina commits to the send rather than the moment the provider confirms it: delivery_status carries what was known then, and a later failure or delivery receipt shows on the message row (GET /conversations/{id}/messages), not as a second event. Internal system lines and internal notes are not messages and fire nothing.

{
  "message_id": "eeeeeeee-0000-4000-8000-000000000002",
  "conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "contact_id": "22222222-0000-4000-8000-000000000001",
  "channel": "whatsapp",
  "type": "text",
  "content": "Hola Rodrigo, te confirmo la visita del jueves a las 10:00.",
  "sender_type": "api_key",
  "delivery_status": "sent",
  "created_at": "2026-09-22T11:08:10.882Z"
}

ticket.opened

A new ticket has been opened on a conversation.

Version 1 · Resource ticket · data requires tickets:read

Fires when. POST /conversations/:id/tickets, the open_ticket / handoff tools, or a stale handoff being reopened with a brand-new ticket.

{
  "ticket_id": "dddddddd-0000-4000-8000-000000000001",
  "origin_conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "reason": "El cliente pide reagendar su visita",
  "opened_by": "human",
  "opened_via": "admin_ui",
  "brand": null
}

ticket.reopened

A previously resolved or closed ticket has been reopened.

Version 1 · Resource ticket · data requires tickets:read

Fires when. reopenTicket() in the ticket service — typically triggered by new inbound activity on a stale handoff.

{
  "ticket_id": "dddddddd-0000-4000-8000-000000000001",
  "origin_conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "reason": "customer_replied",
  "brand": null
}

ticket.resolved

A ticket has transitioned to status=resolved.

Version 1 · Resource ticket · data requires tickets:read

Fires when. PUT /tickets/:id/close (which resolves, despite the path), the auto-resolve worker, and a conversation resolve cascading to its ticket when no sibling conversation is still active. NOT on PUT /tickets/:id/status with status=resolved — that route sets the column without stamping resolved_by/resolved_at, so it has never emitted this.

{
  "ticket_id": "dddddddd-0000-4000-8000-000000000001",
  "origin_conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "resolved_by": "human",
  "resolved_at": "2026-09-22T11:15:06.653Z",
  "brand": null
}

ticket.closed

A ticket has transitioned to status=closed (terminal).

Version 1 · Resource ticket · data requires tickets:read

Fires when. A conversation is closed (auto-close worker after the grace window, or a manual close) and no other open conversation holds the ticket.

{
  "ticket_id": "dddddddd-0000-4000-8000-000000000001",
  "origin_conversation_id": "bbbbbbbb-0000-4000-8000-000000000001",
  "closed_by": "auto",
  "brand": null
}

sla.breached

An open ticket crossed an applicable SLA policy target (first response or resolution). Fired once per (ticket, policy, breach type).

Version 1 · Resource ticket · data requires tickets:read

Fires when. The SLA monitor worker (10-min tick) detects a newly-breached open ticket. Business hours are honoured when the policy is business_hours_only.

{
  "ticket_id": "9b1c…",
  "ticket_display_id": "T-1247",
  "policy_id": "ec95…",
  "policy_name": "Soporte estándar",
  "breach_type": "resolution",
  "target_minutes": 1440,
  "elapsed_seconds": 95400,
  "assignee": "Paulina Rojas",
  "breached_at": "2026-06-07T18:20:00.000Z"
}

agent_scenario_run.completed

An Agent Evals scenario run reached a terminal VERDICT (passed | partial | failed | error) — ADR 0098. A cancelled run does not fire it: the configuration moved under the run (or a human stopped it), so there is no result to report and a mass cancellation would otherwise be one webhook per run.

Version 1 · Resource agent_scenario_run · data requires ai_agents:read

Fires when. The scenario-run worker finishes a run queued by POST /ai-agents/:id/scenarios/run, a single-scenario run, or a publish.

{
  "run_id": "3c1e2d4f-…",
  "scenario_id": "9a7b6c5d-…",
  "scenario_display_id": "EV-12",
  "ai_agent_id": "7c2e3a0e-…",
  "agent_version_kind": "draft",
  "batch_id": "b1a2c3d4-…",
  "status": "failed",
  "score": 0,
  "hard_fails": [
    {
      "id": "grounded-3",
      "kind": "grounded",
      "evidence": "turn 1: not in any tool result → 10:20"
    }
  ],
  "duration_ms": 48210
}

agent_scenario_suite.completed

An Agent Evals SUITE run finished — every scenario run in its batch reached a terminal status (ADR 0098 phase 1B).

Version 1 · Resource agent_scenario_suite_run · data requires ai_agents:read

Fires when. The last run of the suite's batch finishes, whatever started it: POST /ai-agents/:id/scenario-suites/:suiteId/run, the nightly cron, or a publish of an agent that has a golden suite. Exactly once per suite run — the completion flip is a conditional update.

{
  "suite_run_id": "5f6e7d8c-…",
  "suite_id": "1a2b3c4d-…",
  "suite_name": "Golden",
  "kind": "golden",
  "ai_agent_id": "7c2e3a0e-…",
  "batch_id": "b1a2c3d4-…",
  "trigger": "cron",
  "agent_version_kind": "live",
  "agent_version_number": 41,
  "summary": {
    "n": 66,
    "passed": 54,
    "partial": 7,
    "failed": 4,
    "error": 1,
    "hard_fails": 4,
    "pass_rate": 83.1,
    "flaky": 2,
    "cost_usd": 1.842,
    "duration_ms": 412000
  },
  "delta": {
    "pass_rate": -3.1,
    "vs_suite_run_id": "4e5d6c7b-…"
  }
}

ai_agent.publish

An AI agent draft has been published as the live config.

Version 1 · Resource ai_agent · data requires ai_agents:read

Fires when. POST /ai-agents/:id/publish.

{
  "ai_agent_id": "7c2e3a0e-…",
  "name": "Soporte Vitrina",
  "updated_at": "2026-05-15T03:47:40.357Z"
}

ai_agent_graph.publish

A multi-agent graph was published — the draft topology became the live one, snapshotted as a new immutable version.

Version 1 · Resource ai_agent_graph · data requires ai_agents:read

Fires when. The graph publish seam validates the draft and inserts the version row (ai-agent-graph.service). The eval cascade that may follow does not gate the event.

{
  "tenant_id": "00000000-0000-4000-8000-000000000001",
  "graph_id": "9f1c6b40-3a2e-4f58-9d17-70c4f1a2b3d5",
  "version_id": "d0a7e912-5c84-4b6f-8e1a-2f9c7b3d0e45",
  "version_number": 7,
  "topology": "supervisor"
}

cost.budget_alert

An AI spend threshold was crossed. ⚠ ONE NAME, THREE PRODUCERS, THREE SHAPES — branch on the keys you get, not on a single schema. The Copilot credit gate emits domain: "copilot" with the credit counters; the Copilot dollar-margin guard emits domain: "copilot" with the USD limits; the graph runtime budget emits tenant_id + pct and no domain at all. Every field below is therefore optional in practice.

Version 1 · Resource workspace · data requires billing:read

Fires when. A tenant exhausts its monthly Copilot credit allowance, crosses its soft or hard USD margin limit (once each per month — the row carries the dedupe stamp), or crosses 50%, 80% or 100% of its monthly graph-runtime cost budget (once per threshold per month).

{
  "domain": "copilot",
  "month": "2026-09",
  "severity": "soft",
  "used_usd": 41.28,
  "soft_limit_usd": 40,
  "hard_limit_usd": 60
}

runtime.budget_exceeded

A multi-agent graph turn hit one of its runtime ceilings and was cut short. The turn still answers; what stopped is the orchestration, so a graph firing this repeatedly is mis-shaped rather than merely busy.

Version 1 · Resource ai_agent_graph · data requires ai_agents:read

Fires when. The graph runtime refuses to go further on one of four ceilings: recursion depth, fan-out width, per-node turns, or evaluator-loop iterations.

{
  "tenant_id": "00000000-0000-4000-8000-000000000001",
  "graph_id": "9f1c6b40-3a2e-4f58-9d17-70c4f1a2b3d5",
  "topology": "evaluator_loop",
  "reason": "evaluator_iterations"
}

kb.source.create

A new knowledge-base source has been added to the workspace.

Version 1 · Resource kb_source · data requires kb:read

Fires when. POST /kb/sources.

{
  "kb_source_id": "b2…",
  "title": "Devoluciones — política",
  "tags": [
    "returns",
    "policy"
  ]
}

kb.source.embed

A KB source has been (re-)embedded; vectors are ready for retrieval.

Version 1 · Resource kb_source · data requires kb:read

Fires when. POST /kb/sources/:id/embed (manual) or the kb-ingestion worker after content changes.

{
  "kb_source_id": "b2…",
  "chunks": 47
}

kb.source.update

A knowledge-base source’s summary, tags, status or verified_until changed.

Version 1 · Resource kb_source · data requires kb:read

Fires when. PUT /kb/sources/:id.

{
  "kb_source_id": "a5a5a5a5-0000-4000-8000-000000000001",
  "fields": [
    "status"
  ]
}

kb.source.delete

A knowledge-base source was HARD-deleted — the row and its embedded chunks are gone; retrieval can no longer return it.

Version 1 · Resource kb_source · data requires kb:read

Fires when. DELETE /kb/sources/:id.

{
  "kb_source_id": "a5a5a5a5-0000-4000-8000-000000000001"
}

kb_file.uploaded

A document was added to the workspace’s knowledge file library. A 201 here means the bytes are stored, not that the file is searchable yet — ingestion runs best-effort on a worker.

Version 1 · Resource kb_file · data requires kb:read

Fires when. POST /kb-files (multipart upload).

{
  "kb_file_id": "a6a6a6a6-0000-4000-8000-000000000001",
  "name": "Garantías 2026.pdf",
  "content_type": "application/pdf"
}

kb_file.deleted

A knowledge file was removed from the workspace (ADR 0093 — a soft delete: the row survives tombstoned, but every agent attachment goes and the embedded chunks are purged, so this is the customer-visible ending).

Version 1 · Resource kb_file · data requires kb:read

Fires when. DELETE /kb-files/:id.

{
  "kb_file_id": "a6a6a6a6-0000-4000-8000-000000000001"
}

skill.created

A new skill was added to the tenant library.

Version 1 · Resource skill · data requires ai_agents:read

Fires when. POST /skills.

{
  "skill_id": "a4a4a4a4-0000-4000-8000-000000000001",
  "name": "Agendar hora"
}

skill.updated

A skill’s content or channel_overrides changed — applies instantly to every agent it is attached to; there is no draft/publish step for a skill.

Version 1 · Resource skill · data requires ai_agents:read

Fires when. PUT /skills/:id.

{
  "skill_id": "a4a4a4a4-0000-4000-8000-000000000001",
  "name": "Agendar hora"
}

skill.deleted

A skill was removed (ADR 0093 — soft delete): it leaves the library and every agent it was attached to immediately.

Version 1 · Resource skill · data requires ai_agents:read

Fires when. DELETE /skills/:id.

{
  "skill_id": "a4a4a4a4-0000-4000-8000-000000000001"
}

custom_tool.created

A new custom tool was added to the Tool Store.

Version 1 · Resource custom_tool · data requires functions:read

Fires when. POST /custom-tools.

{
  "custom_tool_id": "a7a7a7a7-0000-4000-8000-000000000001",
  "name": "consultar_clima"
}

custom_tool.updated

A custom tool’s definition changed — its request template, parameters, auth configuration or enabled state. Fires from both the full-replace (PUT) and partial (PATCH) routes.

Version 1 · Resource custom_tool · data requires functions:read

Fires when. PUT or PATCH /custom-tools/:id.

{
  "custom_tool_id": "a7a7a7a7-0000-4000-8000-000000000001",
  "name": "consultar_clima"
}

custom_tool.deleted

A custom tool was removed. Every agent wired to it loses it immediately; past tool_invocation audit rows survive.

Version 1 · Resource custom_tool · data requires functions:read

Fires when. DELETE /custom-tools/:id.

{
  "custom_tool_id": "a7a7a7a7-0000-4000-8000-000000000001"
}

lead.created

A new lead has been opened — an opportunity the workspace is now working: a buyer asking about a car, a patient asking for a treatment, a company asking for a quote.

Version 1 · Resource lead · data requires leads:read

Fires when. POST /leads, POST /leads/from-conversation, POST /leads/import, the create_lead AI tool, or a marketplace / dealer-website ingest.

{
  "lead_id": "b9e4a1c2-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
  "contact_id": "22222222-0000-4000-8000-000000000001",
  "pipeline_id": "44444444-0000-4000-8000-000000000001",
  "stage_id": "55555555-0000-4000-8000-000000000001",
  "source": "conversation",
  "intent": "buy",
  "title": "María — prueba de manejo Corolla 2022",
  "value_amount": 8990000,
  "value_currency": "CLP",
  "owner_user_id": "3897d483-9e84-4971-8b17-9a41a6811966",
  "team_id": null
}

lead.stage_changed

A lead moved to a different stage of its board. EVERY stage change fires this — the REST move, a drag on the board, an AI tool, a quick action that closes the lead, the lead reviewer — so a receiver that tracks progress needs only this one event.

Version 1 · Resource lead · data requires leads:read

Fires when. PUT /leads/:id/stage, PUT /leads/:id/won | /lost | /unqualify | /reopen, the update_lead_stage AI tool, or the lead reviewer moving a card. NOT on a no-op move (already on that stage), and not on PUT /leads/:id/pipeline — that one reports its own stage move inside lead.pipeline_changed.

{
  "lead_id": "b9e4a1c2-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
  "from_stage_id": "55555555-0000-4000-8000-000000000001",
  "to_stage_id": "55555555-0000-4000-8000-000000000002",
  "to_stage_slug": "contacted",
  "reason": "la llamamos y confirmó la hora"
}

lead.pipeline_changed

A lead was reclassified onto a different sales board, landing on that board’s first stage.

Version 1 · Resource lead · data requires leads:read

Fires when. PUT /leads/:id/pipeline or the update_lead_pipeline AI tool. No separate lead.stage_changed fires for the landing stage — this event already carries it.

{
  "lead_id": "b9e4a1c2-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
  "from_pipeline_id": "44444444-0000-4000-8000-000000000001",
  "to_pipeline_id": "44444444-0000-4000-8000-000000000002",
  "from_stage_id": "55555555-0000-4000-8000-000000000002",
  "to_stage_id": "55555555-0000-4000-8000-000000000003",
  "reason": "es una venta mayorista"
}

lead.assigned

A lead was (re)assigned to an owner or a team. One assignee owns the whole relationship, so the lead’s conversations and their tickets move with it.

Version 1 · Resource lead · data requires leads:read

Fires when. PUT /leads/:id/assign, PUT /leads/:id with owner_user_id, or the team rotation picking an owner on create.

{
  "lead_id": "b9e4a1c2-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
  "owner_user_id": "3897d483-9e84-4971-8b17-9a41a6811966",
  "team_id": "cccccccc-0000-4000-8000-000000000001"
}

lead.won

A lead closed in the workspace’s favour.

Version 1 · Resource lead · data requires leads:read

Fires when. PUT /leads/:id/won, or any move onto a stage whose category is won. Only on the STATUS FLIP: moving an already-won lead between two won columns is a board tidy-up, not a second sale.

{
  "lead_id": "b9e4a1c2-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
  "reason": "cerró con financiamiento propio",
  "value_amount": 8750000,
  "value_currency": "CLP"
}

lead.lost

A real opportunity did not close.

Version 1 · Resource lead · data requires leads:read

Fires when. PUT /leads/:id/lost, or any move onto a stage whose category is lost. Status flip only, as for lead.won.

{
  "lead_id": "b9e4a1c2-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
  "reason": "compró en otra parte",
  "value_amount": 8990000,
  "value_currency": "CLP"
}

lead.unqualified

There was never an opportunity here — the wrong product, the wrong workspace, a duplicate, a test. A DISTINCT outcome from lead.lost: unqualified leads are excluded from win rate on both sides, so qualifying early never looks like losing.

Version 1 · Resource lead · data requires leads:read

Fires when. PUT /leads/:id/unqualify, or any move onto a stage whose category is unqualified. Status flip only, as for lead.won.

{
  "lead_id": "b9e4a1c2-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
  "reason": "buscaba un servicio que no ofrecemos",
  "value_amount": null,
  "value_currency": "CLP"
}

macro.applied

A macro has been applied to a conversation AND the macro opts into the webhook notification (i.e. its action list includes a run_webhook step). Lean payload — consumers use the ids to fetch detail if they need it.

Version 1 · Resource conversation · data requires conversations:read

Fires when. POST /macros/:id/apply with a conversation_id, when the macro's actions array contains at least one step with type=run_webhook. Fires once per apply regardless of how many run_webhook steps the macro has.

{
  "macro_id": "8f74aa7c-df40-478d-b5f5-5cfc2eb98da4",
  "macro_name": "Send return label",
  "conversation_id": 10031,
  "ticket_id": 10042,
  "contact_id": 142,
  "executed_steps": [
    {
      "type": "send_message",
      "ok": true
    },
    {
      "type": "add_label",
      "ok": true
    },
    {
      "type": "change_status",
      "ok": true
    },
    {
      "type": "run_webhook",
      "ok": true
    }
  ],
  "applied_by_user_id": "3897d483-9e84-4971-8b17-9a41a6811966",
  "applied_at": "2026-05-15T03:47:40.357Z"
}

stock.source_retired

Retiro de fuente (ADR 0031): a decommissioned import source handed its vehicles to dealer ownership.

Version 1 · Resource marketplace_integration · data requires marketplace:read

Fires when. POST /api/v1/vehicles/source-retirement/execute completes (once per retired source).

{
  "integration_id": "a3f1…",
  "provider": "veekls",
  "retired": 156,
  "revived": 2,
  "kept_hidden": 3
}

stock.synced

A stock integration finished importing active inventory from a marketplace portal.

Version 1 · Resource marketplace_integration · data requires marketplace:read

Fires when. syncStock() completes successfully (manual POST /marketplaces/:id/sync or the scheduled tick).

{
  "integration_id": "a3f1…",
  "provider": "chileautos",
  "vehicles_imported": 12,
  "vehicles_updated": 38,
  "vehicles_deactivated": 3
}

vehicle.published

A vehicle was published (or re-published) to a marketplace portal.

Version 1 · Resource vehicle · data requires stock:read

Fires when. publishVehicle() succeeds for a portal via POST /vehicles/:id/publish.

{
  "vehicle_id": "c8d2…",
  "integration_id": "a3f1…",
  "provider": "chileautos",
  "external_id": "6f2b1f7e-1f2a-4c3d-9e8f-0a1b2c3d4e5f"
}

vehicle.unpublished

A vehicle’s publication was removed from a marketplace portal — either a synchronous unpublish or a Facebook Marketplace device-agent task confirming a remove it had only enqueued.

Version 1 · Resource vehicle · data requires stock:read

Fires when. unpublishVehicle() succeeds via DELETE /vehicles/{id}/publications/{pubId}, or the device agent reports a remove task done via POST /device-agent/tasks/{id}/result (facebook_marketplace — the enqueue itself fires nothing; only the confirmed removal does).

{
  "vehicle_id": "c8d2…",
  "integration_id": "a3f1…",
  "provider": "mercadolibre",
  "external_id": "MLC-1234567890"
}

vehicle.publish_failed

A publish, update or unpublish attempt against a marketplace portal failed — the portal rejected it, the connection errored, or (Facebook Marketplace) the device agent reported the task could not complete.

Version 1 · Resource vehicle · data requires stock:read

Fires when. The per-integration catch in publishVehicle() via POST /vehicles/{id}/publish, or the device agent reporting a publish/update/remove task failed via POST /device-agent/tasks/{id}/result.

{
  "vehicle_id": "c8d2…",
  "integration_id": "a3f1…",
  "provider": "chileautos",
  "error": "The portal rejected the listing: missing required field \"version\"."
}

vehicle.created

A vehicle entered this workspace — one event per car, whichever door it came through: the manual/API create (POST /vehicles) or a marketplace stock import. Use it to mirror the lot: id is the handle every other endpoint takes, and url fetches the full record. A car that is MERGED into one you already know about does not fire this event (the identity resolver attached the new listing to the existing vehicle, so no car appeared); neither does a re-import of a car already in stock.

Version 1 · Resource vehicle · data requires stock:read

Fires when. A vehicle row is inserted — vehicle.service create (manual/API intake) or either insert door of the marketplace-sync importer (a newcomer, and a newcomer whose plate conflicted and was imported plate-absent). Retries of one delivery reuse the event id.

{
  "id": "c8d24f0e-7a1b-4c3d-9e8f-0a1b2c3d4e5f",
  "patente": "KXRT52",
  "vin": "JTDBR32E730123456",
  "make": "Toyota",
  "model": "Yaris",
  "version": "XLS 1.5 AT",
  "year": 2019,
  "km": 48200,
  "price": 8990000,
  "status": "disponible",
  "tenencia": "propio",
  "location": {
    "id": "25424bd5-57e1-412c-a0fe-5c375608cef7",
    "name": "Manquehue"
  },
  "source": "chileautos",
  "created_at": "2026-09-15T13:22:41.118Z",
  "url": "https://api.vitrinadev.com/api/v1/vehicles/c8d24f0e-7a1b-4c3d-9e8f-0a1b2c3d4e5f"
}

vehicle.attachment.created

A document was filed into a vehicle's expediente — padrón, cédula del consignante, contrato firmado, certificado de anotaciones vigentes or factura. The event carries METADATA AND A FETCH URL, never file bytes and never a signed URL: GET content_url with an API key holding vehicle_registry:read and the bytes stream back (every read is audited). ⚠ PERSONAL DATA: filename is chosen by the person who uploaded the file and regularly carries a natural person's name or RUT, and a cedula is a third party's identity document. Receiving these makes your platform a PROCESSOR of the dealership's personal data under Ley 21.719 — store them under the dealership's retention rules, keep them out of logs, and be able to erase them on request.

Version 1 · Resource vehicle_attachment · data requires vehicle_registry:read

Fires when. The expediente upload seam persists the row (POST /vehicle-attachments, the only upload door — a transferencia references an already-filed document rather than uploading its own). Retries of one delivery reuse the event id.

{
  "id": "3f9c1a52-64bd-4a71-8e2c-9b7d5e3a1c04",
  "vehicle_id": "c8d24f0e-7a1b-4c3d-9e8f-0a1b2c3d4e5f",
  "kind": "padron",
  "filename": "padron_KXRT52.pdf",
  "mime_type": "application/pdf",
  "byte_size": 184320,
  "uploaded_at": "2026-09-15T13:31:08.402Z",
  "content_url": "https://api.vitrinadev.com/api/v1/vehicle-attachments/3f9c1a52-64bd-4a71-8e2c-9b7d5e3a1c04/content"
}

mercadolibre.order

A Mercado Libre order notification (orders_v2) was received for a connected seller.

Version 1 · Resource marketplace_integration · data requires marketplace:read

Fires when. The MELI notifications worker processes an orders_v2 topic. It also upserts the buyer as a contact and creates a sales lead (source=marketplace, deduped by order id) when the tenant has a sales pipeline; this event fires regardless for downstream automation/reporting.

{
  "integration_id": "a3f1…",
  "order_id": 2000003508419013,
  "status": "paid",
  "total_amount": 8990000,
  "currency_id": "CLP",
  "buyer": {
    "id": 123456789,
    "nickname": "COMPRADOR123"
  },
  "items": [
    {
      "id": "MLC123",
      "title": "Toyota Yaris XLS 2019",
      "qty": 1
    }
  ]
}

mercadolibre.vis_lead

A Mercado Libre vehicle-classified buyer lead (VIS Leads) was received for a connected seller.

Version 1 · Resource marketplace_integration · data requires marketplace:read

Fires when. The MELI notifications worker processes a vis_leads topic (buyer contact via whatsapp/call/question/visit/contact request/reservation). It also upserts the buyer as a contact and creates a sales lead (source=marketplace, deduped by lead id) when the tenant has a sales pipeline; this event fires regardless for downstream automation/reporting.

{
  "integration_id": "a3f1…",
  "lead_id": "44115522",
  "item_id": "MLC123",
  "contact_type": "whatsapp",
  "status": "active"
}

appointment.booked

An appointment was booked and confirmed — a test drive, a consulta, a service visit: whatever the workspace puts in its diary.

Version 1 · Resource appointment · data requires appointments:read

Fires when. POST /appointments, the agent booking tool, the embed widget, the clinic diary (POST /clinic/agenda/appointments), or a hold that was confirmed. NOT for kind=block (an admin unavailability marker is not a booking).