---
title: "Call received event"
method: POST
path: "call.received"
tags: ["Webhook Events"]
---

# Call received event

`POST call.received` (webhook)

Fired when a WhatsApp Business Call connects. For inbound (UIC) calls
the event fires at the moment our Telnyx trunk bridges the consumer
leg to the customer's forward-to destination; for outbound (BIC)
calls it fires immediately after Meta accepts the connect. Branch on
`call.direction` to distinguish.

## Payload

- WebhookPayloadCallReceived — Webhook payload for the `call.received` event. Fires for both inbound (UIC) and outbound (BIC) calls; branch on `call.direction` to tell them apart.
  - `id` string, required — Stable webhook event ID
  - `event` 'call.received', required
  - `call` object, required
    - `id` string — Internal Zernio Call doc id
    - `metaCallId` string, nullable — Meta wacid.* call id when known
    - `accountId` string
    - `phoneNumberId` string — Meta phone_number_id
    - `direction` 'inbound' | 'outbound'
    - `from` string — Consumer wa_id / E.164
    - `to` string — Business number (E.164)
    - `forwardTo` string — Destination snapshot at routing time
    - `contactId` string
    - `conversationId` string
    - `startedAt` string, date-time
  - `account` InboxWebhookAccount, required — The account context included in inbox webhook payloads.
    - `id` string, required — Social account ID
    - `accountId` string — Social account ID (same value as id). Canonical field so consumers can filter every webhook event on one field (e.g. route staging vs production by account). id is kept for backward compatibility.
    - `profileId` string — Zernio profile (workspace) ID this account belongs to. Use it to route or filter inbox webhooks by workspace. This is the profile ID only, not its name (resolve the name via the API with this ID). Optional; omitted on the shared WhatsApp sandbox account and when the account has no resolvable profile.
    - `platform` string, required
    - `username` string, required
    - `displayName` string
  - `timestamp` string, date-time, required

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/f81ca70ea6b9/schema)