Google Calendar — Create event

Google Calendar — Create event

Tipo: googlecalendar-create-event  ·  Paquete: Google Calendar v1.0.5  ·  Salida: Dictionary<string,object>

Crea un evento en un calendario. Define el título, el rango de fechas y, opcionalmente, ubicación, descripción, invitados y zona horaria. Devuelve el evento creado con su ID para actualizarlo, cancelarlo o registrarlo después.

Cómo funciona

Crea el evento en calendarId (por defecto primary) con una llamada a Google:

• start y end aceptan un DateTime o un texto ISO 8601 (2026-06-15T14:30:00) y se envían a Google con desfase explícito, sin depender de la configuración regional del equipo. Desde la versión 1.0.5.
• Una hora sin desfase se interpreta en la zona de timeZone (IANA, p. ej. America/Bogota) o, si lo omites, en la zona del calendario. Con desfase (-05:00) se respeta el instante exacto. timeZone también queda como zona del evento.
• Con allDay = true se usa solo la parte de fecha. La fecha de fin es exclusiva: para un evento del 15 de junio, start = "2026-06-15" y end = "2026-06-16".
• attendees acepta un texto con emails separados por , o ;, o una lista de emails.
• Cada ejecución crea un evento nuevo: repetirla con los mismos datos deja eventos duplicados.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
summary	string	—	Título del evento.
start	DateTime | string	—	Inicio: un DateTime o texto ISO 8601, p. ej. 2026-06-15T14:30:00. Para día completo, una fecha (yyyy-MM-dd).
end	DateTime | string	—	Fin, posterior a start, en el mismo formato. Para día completo, el día siguiente al último.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
session	ZoanGoogleCalendarSession	—	Sesión de Google Calendar — Connect. Dentro del body de Connect se hereda y puedes omitirla.
calendarId	string	primary	ID del calendario (de Get calendars). primary es el calendario principal de la cuenta.
allDay	bool	false	Evento de día completo (usa solo la fecha).
timeZone	string	—	Zona horaria IANA del evento, p. ej. America/Bogota; en ella se leen las horas sin desfase. Si se omite, la del calendario.
location	string	—	Ubicación del evento.
description	string	—	Descripción del evento (admite varias líneas).
attendees	string | List	—	Emails de los invitados, separados por , o ;, o como lista.
notify	bool	false	Enviar la invitación por correo a los invitados.

Salida

Devuelve un Dictionary con los datos del evento creado: evento["id"] (úsalo para actualizar, borrar o añadir invitados), evento["htmlLink"] (enlace al evento), evento["start"], evento["end"], evento["attendees"]…

Errores comunes

Mensaje	Causa y solución
'summary' es obligatorio. / 'start' es obligatorio. / 'end' es obligatorio.	Falta el título o una de las fechas, o su expresión dio nulo.
Fecha/hora no válida: «…». Usa ISO 8601 (p. ej. 2026-06-15T14:30:00) o un valor DateTime.	start o end no es un DateTime ni un texto ISO 8601 (por ejemplo, 15/06/2026). Pasa el DateTime directamente o el texto en formato yyyy-MM-ddTHH:mm:ss.
Zona horaria desconocida: «…». Usa una zona IANA como America/Bogota.	timeZone no es una zona IANA válida.
La fecha no trae zona horaria y no se pudo obtener la del calendario. …	La fecha no tiene desfase, timeZone está vacío y la cuenta no pudo leer la zona del calendario. Indica timeZone o incluye el desfase en la fecha.
No hay una sesión de Google Calendar disponible. Indica 'session' desde una actividad googlecalendar-connect o coloca esta actividad dentro del cuerpo de la actividad Connect …	La actividad está fuera del body de Connect y no recibió session. Colócala dentro del body o pasa la sesión guardada.
The service calendar has thrown an exception. HttpStatusCode is BadRequest…	end no es posterior a start (en día completo, fin igual al inicio) o un email de invitado no es válido.
The service calendar has thrown an exception. HttpStatusCode is …	Google rechazó la llamada: calendario o evento inexistente, sin acceso, token vencido o cuota superada. Ver errores de la API de Google.

Ejemplo

Google Calendar — Connect   credential = credential("calendar-equipo")
 └─ body:
      Google Calendar — Create event   summary = "Revisión de propuesta"
                                        start = "2026-06-15T14:30:00-05:00"   end = "2026-06-15T15:30:00-05:00"
                                        location = "Sala 3"   attendees = "cliente@correo.com, ventas@empresa.com"
                                        notify = true   → output: evento
      Log   message = "Evento " + evento["id"] + ": " + evento["htmlLink"]

Actividades relacionadas

• Google Calendar — Update event — modificar el evento.
• Google Calendar — Add attendee — añadir invitados.
• Google Calendar — Get events — buscar eventos.
• Todas las actividades de Google Calendar