WarmablyWarmablyDOCS
Search docs⌘K
Dashboard
API Reference/Endpoints

Create an event

POST/api/linkedin/gateway/calendars/{calendar_id}/events

Creates a new event on one of a connected account's calendars, optionally inviting attendees and attaching a video-conference link.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.

Path parameters

FieldTypeDescription
calendar_id *stringThe calendar to create the event on.

Body parameters

FieldTypeDescription
account_id *stringThe connected account the calendar belongs to.
title *stringThe event's title.
attendees *arrayInvitees: { email } each.
start *objectEither { date_time, time_zone } for a timed event, or { date } for an all-day one.
end *objectSame shape as start.
bodystringThe event's description.
locationstringA free-text location.
transparency"opaque" | "transparent"Whether the event blocks time on free/busy lookups.
visibility"public" | "private"The event's visibility to others.
colorstringA hex color to display the event with.
notifybooleanSend invite emails to attendees. Defaults to false.
guests_can_modifybooleanAllow invited guests to edit the event. Defaults to false.
is_attendees_list_hiddenbooleanHide the attendee list from attendees themselves.
recurrencestring[]RRULE / EXRULE / RDATE / EXDATE lines, per RFC 5545.
conferenceobject{ provider, conference_id?, url? } — provider is one of google_meet, zoom, teams. Omit url to have a new meeting link generated.

Response fields

FieldTypeDescription
object"CalendarEventCreated"Always this value.
event_idstringThe new event's id.

Errors

·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. The account_id doesn't belong to this key.·404 Not Found. No calendar with that id belongs to this account.
CredentialsRequired
AuthorizationBearer wm_live_••••••••
RequestTry it
curl -X POST https://api.warmably.com/api/linkedin/gateway/calendars/c5a2f918-3e6b-4d70-8a19-2f7c6e1b9d40/events \
  -H "Authorization: Bearer wm_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "459993d2-b0e7-4b19-baf9-45252ca324cf",
    "title": "Intro call",
    "attendees": [{ "email": "priya@example.com" }],
    "start": { "date_time": "2026-09-05T15:00:00.000Z", "time_zone": "America/New_York" },
    "end": { "date_time": "2026-09-05T15:30:00.000Z", "time_zone": "America/New_York" }
  }'
Response
201 Created
{
  "object": "CalendarEventCreated",
  "event_id": "e19b4c7a-8f2d-4a63-9e05-1c6a3f8b2d70"
}
No key yet? Create one from Dashboard → API Keys.