Itsconvo Com Webhooks

generated: '2026-11-13'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.itsconvo.com/webhooks.mdx
sources:
- https://docs.itsconvo.com/webhooks.mdx
- https://docs.itsconvo.com/api-reference/webhooks/list-webhooks.mdx
- https://docs.itsconvo.com/api-reference/webhooks/create-webhook.mdx
- https://docs.itsconvo.com/api-reference/webhooks/delete-webhook.mdx
description: Convo webhooks deliver signed JSON POSTs for a fixed set of events.
events:
- event: conversation.created
  description: The desktop app saves a new call after it ends.
- event: transcript.ready
  description: The desktop app saves a call's transcript. `segmentCount` is the number of segments in that save.
- event: transcript.failed
  description: Saving the transcript failed.
- event: conversation.keypoints.ready
  description: Key points are generated, by the app after a call or by `POST /keypoints`. Returning saved key points doesn't fire it.
- event: conversation.summary.ready
  description: With `keypoints.ready`, when the key points have sections.
- event: conversation.action_items.ready
  description: With `keypoints.ready`, when there are action items.
- event: conversation.feedback.ready
  description: Feedback is generated, in the app or by `POST /feedback`.
- event: conversation.shared
  description: A call is shared, in the app or by `POST /share`.
- event: conversation.updated
  description: A call is renamed with `PATCH /conversations/{id}`.
- event: conversation.deleted
  description: A call is deleted, in the app or through the API.
- event: webhook.test
  description: '`POST /webhooks/test`.'
delivery:
  signature: HMAC‑SHA256 of the raw request body, hex‑encoded, using the secret returned when the webhook is created (header `X-Convo-Signature`).
  content_type: application/json (header `Content-Type`), event name also in header `X-Convo-Event`.
note: Convo sends each event once, does not retry failed deliveries, and provides no delivery log.
docs: https://docs.itsconvo.com/webhooks.mdx