Skip to content

Google: Transfers a secondary calendar between users within a Google Workspace organization Requires user authentication with Manage Calendars administrator privilege, and one of the following authorization scopes: - https: www googleapis com auth calendar - https: www googleapis com auth calendar calendars In the request, set use Admin Access to true The secondary calendar must be active to be transferred Transferring disabled or deleted calendars isn't supported

Google calendarCalendars.calendarCalendarsTransferOwnership: arguments, response, policy and SDK examples.

← calendar_calendars operations · Get started · OpenAPI downloads

Contract 2026-10-27 · Operation google.calendar_calendars_transferownership

Provider route: POST /calendar/v3/calendars/{calendarId}/transferOwnership. Alter supplies the connection’s credentials and routing.

Install @alter-ai/sdk @alter-ai/google with npm, or alter-sdk-google with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { GoogleIntegration } from "@alter-ai/google";
async function execute(input: Parameters<GoogleIntegration["calendarCalendars"]["calendarCalendarsTransferOwnership"]>[0]) {
const app = new App({ apiKey: process.env.ALTER_API_KEY! });
try {
const provider = new GoogleIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
const call = await provider.calendarCalendars.calendarCalendarsTransferOwnership(input);
const result = await call.wait();
return result.bodyJson();
} finally {
await app.close();
}
}
import os
from alter_sdk import App
from alter_sdk_google import GoogleIntegration
async def execute(arguments):
async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
provider = GoogleIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
call = await provider.calendar_calendars.calendar_calendars_transfer_ownership(arguments)
result = await call.wait()
return result.body_json()
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
pathobjectRequired within parentAdditional keys: not allowed
path.calendarIdstringRequired within parentCalendar identifier. To retrieve calendar IDs, call the calendarList.list method.
queryobjectRequired within parentAdditional keys: not allowed
query.fieldsstringOptionalSelector specifying which fields to include in a partial response.
query.prettyPrintbooleanOptionalReturns response with indentations and line breaks.
Default: true
query.quotaUserstringOptionalAn opaque string that represents a user for quota purposes. Must not exceed 40 characters.
query.userIpstringOptionalDeprecated. Please use quotaUser instead.
query.newDataOwnerstringRequired within parentThe email address of a user who will become the data owner of the calendar.
query.useAdminAccessbooleanRequired within parentWhen true, the method runs using the user’s Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the Manage Calendars privilege. This method currently only supports admin access, thus only true is accepted for this field.

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

FieldTypePresenceDescription and constraints
$nullRoot

SDK function policy ID: google.calendar_calendars_transferownership. Catalog operation: calendar.calendars.transferOwnership. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Required provider scopes: ["https://www.googleapis.com/auth/calendar", "https://www.googleapis.com/auth/calendar.calendars"]

No-content response statuses: [204]

Official provider source

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.