auth POST /v1/inbox/events

Recommended endpoint. Stores the full JSON payload in Inbox for later processing.

curl -sS https://api.invoxweb.com/v1/inbox/events \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source_ref": "cf7:form123:submission456",
    "channel_ref": "site:landing-x",
    "contact": {"name":"Ana","email":"ana@x.com"},
    "message": {"type":"text","text":"I want a quote"},
    "meta": {"form_id":123,"page_url":"https://..."}
  }'

{
  "ok": true,
  "id": 12345
}

legacy POST /api/inbox

Compatibility alias (e.g., older plugins). Same behavior as /v1/inbox/events.

Best Practices

Use source_ref as an idempotency key to prevent duplicates from re-sends.

Use channel_ref to group messages into the same conversation (WhatsApp chat id, etc.).