Recaudo Docs
Sign up

Events

Meta events

Every event Recaudo sends to Meta (pixel / Conversions API and WhatsApp dataset) with what Meta answered. It is the same log as Settings → Meta and is kept for 90 days.

List events

GET /v1/meta-events

Newest first. Filter by status (sent, failed, skipped), destination (pixel, whatsapp), event_name, conversation or customer.

Request 
curl "https://recaudo.app/api/v1/meta-events?status=failed" \
  -H "Authorization: Bearer sk_live_tu_secret_key"
Response 
{
  "object": "list",
  "data": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "object": "meta_event",
      "event_name": "Purchase",
      "destination": "pixel",
      "status": "failed",
      "trigger": "payment",
      "conversation_id": null,
      "customer_id": "98765432-10fe-dcba-9876-543210fedcba",
      "value": 1500.0,
      "currency": "MXN",
      "matched_keys": ["fn", "ln"],
      "error": {
        "code": "100/2804050",
        "message": "…",
        "explanation": "No data to recognize the person",
        "fix": "Meta needs at least the email, the phone or the ad click. Link the payment to a customer or ask for their email at checkout."
      },
      "created_at": "2026-11-11T18:20:00+00:00"
    }
  ],
  "has_more": false,
  "page": 1,
  "url": "/v1/meta-events"
}

matched_keys tells which data identifies the person (without their values). For events that were not accepted, error has the code from Meta, its message and the explanation with how to fix it.

Was this page helpful? Thanks for letting us know.
Esc