OverviewAPI ReferenceResources
User

Get profile and usage

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

GET
/api/v1/user/profile

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/user/profile" \
  -H "Authorization: Bearer <token>"

User profile and usage stats

{
  "data": {
    "profile": {
      "name": "Alice Chen",
      "email": "alice@example.com",
      "timezone": "America/New_York",
      "language": "en",
      "profilePictureUrl": null,
      "createdAt": "2025-09-15T10:00:00.000Z"
    },
    "subscription": {
      "tier": "professional",
      "status": "active",
      "currentPeriodEnd": "2026-04-15T00:00:00.000Z"
    },
    "apiUsage": {
      "aiGenerations": {
        "used": 1240,
        "limit": 15000,
        "remaining": 13760,
        "resetsAt": "2026-04-01T00:00:00.000Z"
      }
    }
  }
}

Was this page helpful?

List calendar events

Returns upcoming events from the calendar connected in the Convo desktop app, Google or Outlook, by start time. Events come in the provider's own format. Declined and cancelled events are left out. Without `timeMax`, Outlook looks 7 days ahead and Google has no end.

List webhooks

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