Get a user

Returns the user and all their connections, including revoked ones. A user exists once they have connected a calendar.

GEThttps://api.bentocal.com/au/v1/users/{user_id}

Authentication

AuthorizationstringheaderBearer <token>required

An API key: bc_{live|test}_{region}_…, from the console.

Path parameters

1 param

user_idstringlength: 1…255required
Your identifier for the end user. URL-encode it.

Responses

An end user, identified by your own id, and their connections.

user_idstringrequired
default_connection_idstring | nullrequired
The connection events are written to when an event write names no connection_id.
connectionsarray of Connectionrequired
created_atstringdate-timerequired
When the user first connected a calendar.

Errors

curl -X GET "https://api.bentocal.com/au/v1/users/<user_id>" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "user_id": "user_123",
  "default_connection_id": "conn_4kT9pQ2vXa7LmN3s",
  "connections": [
    {
      "id": "conn_4kT9pQ2vXa7LmN3s",
      "user_id": "user_123",
      "provider": "google",
      "email": "sam@example.com",
      "display_name": "Sam Lee",
      "status": "active",
      "primary_calendar_id": "sam@example.com",
      "connected_at": "2026-10-01T03:12:45Z",
      "last_used_at": "2026-10-14T22:01:09Z"
    }
  ],
  "created_at": "2026-10-01T03:12:45Z"
}

Authentication

Path parameters

Responses

Was this page helpful?