ExternalEventCreateRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/eventship-com/json-schema/eventship-com-external-event-create-request-schema.json",
  "title": "ExternalEventCreateRequest",
  "description": "Request to create an event via the external API.\n\nThe host is resolved from the API key — no hostId needed.\nGeocoding fields (lat/lng, city/state) are derived from address.\n\nSet ``publish=true`` to create the event and immediately publish it\nas live.  When omitted or ``false``, the event is created as a draft.",
  "x-generated": "2026-11-07",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/eventship-com-openapi.json#/components/schemas/ExternalEventCreateRequest",
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "title": "Title"
    },
    "startDate": {
      "type": "string",
      "format": "date-time",
      "title": "Startdate"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Description"
    },
    "endDate": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Enddate",
      "description": "When the event ends, in the event's timezone. Optional: omit it and the event is created lasting four hours from its start, which you can change at any time with a PATCH."
    },
    "timezone": {
      "type": "string",
      "title": "Timezone",
      "default": "America/Los_Angeles"
    },
    "locationType": {
      "$ref": "#/$defs/EventLocationType",
      "default": "in_person"
    },
    "venue": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Venue"
    },
    "address": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Address"
    },
    "virtualLink": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Virtuallink"
    },
    "externalRegistrationUrl": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Externalregistrationurl"
    },
    "privateLocation": {
      "type": "boolean",
      "title": "Privatelocation",
      "default": false
    },
    "isPublic": {
      "type": "boolean",
      "title": "Ispublic",
      "default": true
    },
    "showGuestList": {
      "type": "boolean",
      "title": "Showguestlist",
      "default": true
    },
    "image": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Image"
    },
    "bannerTemplate": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Bannertemplate"
    },
    "introductionsEnabled": {
      "type": "boolean",
      "title": "Introductionsenabled",
      "default": false
    },
    "sendSaveTheDate": {
      "type": "boolean",
      "title": "Sendsavethedate",
      "default": false
    },
    "feedbackEnabled": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Feedbackenabled"
    },
    "enableAds": {
      "type": "boolean",
      "title": "Enableads",
      "default": false
    },
    "publish": {
      "type": "boolean",
      "title": "Publish",
      "description": "If true, the event is published immediately as live instead of remaining a draft.",
      "default": false
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "title",
    "startDate"
  ],
  "$defs": {
    "EventLocationType": {
      "type": "string",
      "enum": [
        "in_person",
        "virtual",
        "hybrid",
        "global"
      ],
      "title": "EventLocationType",
      "description": "How guests attend an event."
    }
  }
}