---
title: "POST callFlowEventCreated"
method: POST
path: "callFlowEventCreated"
---

# POST callFlowEventCreated

`POST callFlowEventCreated` (webhook)

The `call_flow_event.created` event is delivered when a live call flow reaches a send_event node.

## Payload

- CallFlowEventCreatedEvent
  - `account_id` string, required: The ID of the account in which this event occurred
  - `data` object, required: The data associated with the event
    - `call` object, required: The inbound call that reached the node
      - `contact` object, required
        - `email` string, nullable, required
        - `first_name` string, nullable, required
        - `id` string, required
        - `last_name` string, nullable, required
        - `metadata` object, required
        - `phone_number` string, required
      - `from` string, nullable, required: The caller's E.164 number
      - `id` string, required: The unique identifier for the call
      - `initiated_at` string, date-time, required
      - `phone_number_id` string, nullable, required: The Surge phone number ID
      - `to` string, nullable, required: The Surge number called
    - `call_flow` object, required: The published call flow version used for this call
      - `id` string, required: The call flow ID
      - `version` integer, required
    - `inputs` object, required: The latest matched gather result for each IVR node, keyed by node ID
    - `metadata` object, required: Metadata configured on the node, or an empty object
    - `name` string, required: The event name configured on the node
  - `timestamp` string, date-time, required: The timestamp when this event occurred, in ISO8601 format
  - `type` 'call_flow_event.created', required: The type of the event. Always `call_flow_event.created` for this event.

## Acknowledgement `200`

Return a 200 status to indicate that the data was received successfully

---

[API](https://skmtc.dev/surgeapi/apis/surge.md) - [All operations](https://skmtc.dev/surgeapi/apis/surge/llms.txt) - [OpenAPI document](https://skmtc.dev/surgeapi/apis/surge/revisions/bb534713d694?raw)