OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

calendar.google

Google Calendar integration for event creation, updates, and scheduling automations.

  • Type: integration (integration)
  • Version: 1.0.0
  • Owners: platform.messaging
  • Tags: calendar, google
  • field.key.label
    calendar.google
    field.version.label
    1.0.0
    field.type.label
    integration (integration)
    field.title.label
    calendar.google
    field.description.label

    Google Calendar integration for event creation, updates, and scheduling automations.

  • Type: integration (integration)
  • Version: 1.0.0
  • Owners: platform.messaging
  • Tags: calendar, google
  • field.tags.label
    calendar,google
    field.owners.label
    platform.messaging
    field.stability.label

    Google Calendar integration for event creation, updates, and scheduling automations.

    Source Definition

    export const googleCalendarIntegrationSpec = defineIntegration({
      meta: {
        key: 'calendar.google',
        version: '1.0.0',
        category: 'calendar',
        title: 'Google Calendar API',
        description:
          'Google Calendar integration for event creation, updates, and scheduling automations.',
        domain: 'productivity',
        owners: ['platform.messaging'],
        tags: ['calendar', 'google'],
        stability: StabilityEnum.Beta,
      },
      supportedModes: ['managed', 'byok'],
      capabilities: {
        provides: [{ key: 'calendar.events', version: '1.0.0' }],
      },
      configSchema: {
        schema: {
          type: 'object',
          properties: {
            calendarId: {
              type: 'string',
              description: 'Default calendar identifier (defaults to primary).',
            },
          },
        },
        example: {
          calendarId: 'primary',
        },
      },
      secretSchema: {
        schema: {
          type: 'object',
          required: ['clientEmail', 'privateKey'],
          properties: {
            clientEmail: {
              type: 'string',
              description: 'Service account client email.',
            },
            privateKey: {
              type: 'string',
              description: 'Service account private key.',
            },
            projectId: {
              type: 'string',
              description: 'Google Cloud project ID.',
            },
          },
        },
        example: {
          clientEmail: 'svc-calendar@example.iam.gserviceaccount.com',
          privateKey: '-----BEGIN PRIVATE KEY-----...',
          projectId: 'calendar-project',
        },
      },
      healthCheck: {
        method: 'custom',
        timeoutMs: 4000,
      },
      docsUrl: 'https://developers.google.com/calendar/api',
      constraints: {},
      byokSetup: {
        setupInstructions:
          'Create a Google service account with Calendar access and share the target calendars with the service account email.',
      },
    });