OverviewAPI ReferenceResources
Webhooks

List webhooks

Lists your active webhooks, newest first. Secrets are not returned. Professional and Enterprise.

GET
/api/v1/webhooks

Authorization

AuthorizationRequiredBearer <token>

A Convo API key: convo_ followed by 32 hex characters. Create it in the Convo desktop app under Settings → Convo API.

In: header

curl -X GET "https://www.itsconvo.com/api/v1/webhooks" \
  -H "Authorization: Bearer <token>"

Active webhooks

{
  "data": [
    {
      "id": "8d3f6a52-1c4e-4b7a-9e2d-5f0b8c1a7e34",
      "url": "https://hooks.example.com/convo",
      "events": [
        "conversation.keypoints.ready",
        "transcript.ready"
      ],
      "created_at": "2026-03-10T12:00:00.000Z"
    }
  ]
}

Was this page helpful?

Get profile and usage

Returns your profile, your plan and how many AI credits you have used this month.

Register webhook

Registers a URL for the events you choose. The URL must use HTTPS and can't point to localhost or a private network. Professional plans can have 3 webhooks and Enterprise 999. The `secret` appears only in this response.