Skip to content
HALOWERK

Formatwerk

ics generate

Own serializer: TEXT values are escaped per RFC 5545 3.3.11 (backslash, semicolon, comma, newline), parameter values are quoted and RFC 6868-encoded, lines are folded at 75 octets without splitting UTF-8 characters and end with CRLF. Local times are written with TZID and a VTIMEZONE generated from the IANA rules in luxon (yearly RRULE when the zone follows a fixed rule, otherwise explicit transitions); times with offset become UTC. All-day ends are inclusive in the input and exclusive in.

POST https://format.halowerk.com/v1/ics-generate

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
eventsarrayYes
timezonestringNoDefault IANA zone for local times.
calendar_namestringNo
methodstringNo
dtstampstringNoOptional fixed DTSTAMP (ISO 8601) for reproducible output; default now.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "events"
  ],
  "properties": {
    "events": {
      "type": "array",
      "minItems": 1,
      "maxItems": 500,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "summary",
          "start"
        ],
        "properties": {
          "summary": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500,
            "description": "Title."
          },
          "start": {
            "type": "string",
            "maxLength": 40,
            "description": "YYYY-MM-DD (all-day), local YYYY-MM-DDTHH:mm[:ss] in timezone, or with Z/offset."
          },
          "end": {
            "type": "string",
            "maxLength": 40,
            "description": "End; for all-day events the last day (inclusive)."
          },
          "duration_minutes": {
            "type": "integer",
            "minimum": 1,
            "maximum": 525600,
            "description": "Duration instead of end."
          },
          "timezone": {
            "type": "string",
            "maxLength": 64,
            "description": "IANA zone for this event."
          },
          "description": {
            "type": "string",
            "maxLength": 20000
          },
          "location": {
            "type": "string",
            "maxLength": 1000
          },
          "url": {
            "type": "string",
            "format": "uri",
            "maxLength": 2000
          },
          "status": {
            "type": "string",
            "enum": [
              "TENTATIVE",
              "CONFIRMED",
              "CANCELLED"
            ]
          },
          "transparency": {
            "type": "string",
            "enum": [
              "OPAQUE",
              "TRANSPARENT"
            ]
          },
          "classification": {
            "type": "string",
            "enum": [
              "PUBLIC",
              "PRIVATE",
              "CONFIDENTIAL"
            ]
          },
          "priority": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9
          },
          "sequence": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100000
          },
          "categories": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "string",
              "maxLength": 100
            }
          },
          "geo": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "lat",
              "lon"
            ],
            "properties": {
              "lat": {
                "type": "number",
                "minimum": -90,
                "maximum": 90
              },
              "lon": {
                "type": "number",
                "minimum": -180,
                "maximum": 180
              }
            }
          },
          "organizer": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "email"
            ],
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "email": {
                "type": "string",
                "format": "email"
              }
            }
          },
          "attendees": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "email"
              ],
              "properties": {
                "name": {
                  "type": "string",
                  "maxLength": 200
                },
                "email": {
                  "type": "string",
                  "format": "email"
                },
                "role": {
                  "type": "string",
                  "enum": [
                    "CHAIR",
                    "REQ-PARTICIPANT",
                    "OPT-PARTICIPANT",
                    "NON-PARTICIPANT"
                  ]
                },
                "rsvp": {
                  "type": "boolean"
                }
              }
            }
          },
          "rrule": {
            "type": "string",
            "maxLength": 500,
            "description": "RRULE value, e.g. FREQ=WEEKLY;BYDAY=MO;COUNT=10."
          },
          "exdates": {
            "type": "array",
            "maxItems": 500,
            "items": {
              "type": "string",
              "maxLength": 40
            }
          },
          "alarms": {
            "type": "array",
            "maxItems": 10,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "minutes_before"
              ],
              "properties": {
                "minutes_before": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 40320
                },
                "description": {
                  "type": "string",
                  "maxLength": 500
                }
              }
            }
          },
          "uid": {
            "type": "string",
            "maxLength": 255
          }
        }
      }
    },
    "timezone": {
      "type": "string",
      "maxLength": 64,
      "default": "UTC",
      "description": "Default IANA zone for local times."
    },
    "calendar_name": {
      "type": "string",
      "maxLength": 200
    },
    "method": {
      "type": "string",
      "enum": [
        "PUBLISH",
        "REQUEST"
      ]
    },
    "dtstamp": {
      "type": "string",
      "maxLength": 40,
      "description": "Optional fixed DTSTAMP (ISO 8601) for reproducible output; default now."
    }
  }
}

Open original schema

Published input example

{
  "timezone": "Europe/Berlin",
  "events": [
    {
      "summary": "Team meeting",
      "start": "2026-11-16T10:00",
      "end": "2026-11-16T11:00",
      "alarms": [
        {
          "minutes_before": 15
        }
      ]
    }
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’