WhatsApp

Send WhatsApp conversion event — estimate

Price the request without executing it. Same body as POST /v1/messaging/whatsapp/conversions.

post/v1/messaging/whatsapp/conversions/estimate

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/messaging/whatsapp/conversions/estimate
  • Auth: HTTP bearer

Request body

emailstring email

User email. Normalized + SHA-256 hashed before sending to Meta.

valuenumber

Conversion value (e.g. order total).

eventIdstring required

Stable dedup key. Reuse to suppress duplicate events (Meta dedupes against pixel events with the same id).

currencystring

ISO 4217 currency code (e.g. USD).

testCodestring

Meta test_event_code passthrough. Routes the event to the Test Events tab in Events Manager instead of the production dataset, useful for development.

accountIdstring required

WhatsApp SocialAccount ID.

eventName'LeadSubmitted' | 'Purchase' | 'AddToCart' | 'InitiateCheckout' | 'ViewContent' required

Live-verified allowlist of event names accepted by Meta's CAPI for Business Messaging (Graph API v25.0). Other standard pixel events including Lead, CompleteRegistration, Subscribe, Schedule, Contact, StartTrial, AddPaymentInfo, Search, and SubmitApplication are rejected with subcode 2804066 ("Messaging Event Invalid Event Type") on action_source = business_messaging events. Custom event names are also rejected.

Use LeadSubmitted (NOT Lead) for lead-style conversions.

eventTimenumber

Unix seconds. Defaults to the time of the request when omitted. Meta's attribution window is 7 days from click; events older than that lose attribution.

phoneE164string

Contact phone number, digits only with no '+'. When used in lieu of conversationId, the handler resolves to the most recent CTWA-attributed conversation for this phone on the supplied account.

contentIdsstring[]

Optional product / content identifiers.

externalIdstring

Stable customer identifier. Lowercased + SHA-256 hashed before sending to Meta.

conversationIdstring

Zernio Conversation _id (preferred lookup). The conversation must have a captured ctwa_clid in metadata (set automatically by the WhatsApp webhook on the first inbound message after a CTWA ad click).

Response

Estimate

operationstring
estimated_creditsnumber
credits_to_reservenumber
estimated_usageobject
notestring nullable
sufficientboolean

Changes

No recorded changes to this operation across all 2 revisions of this API.