Raw schema
{
"type": "object",
"properties": {
"event_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The event id (24-character hex id)."
},
"name": {
"description": "New event name.",
"type": "string",
"minLength": 1
},
"description": {
"description": "New description.",
"type": "string"
},
"timezone": {
"description": "New IANA timezone.",
"type": "string",
"minLength": 1
},
"event_location": {
"description": "Where the event happens: online, address (geocoded), custom (free text) or toBeAnnounced.",
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "online"
},
"onlineUrl": {
"description": "Link attendees join at.",
"type": "string"
},
"instructions": {
"description": "Joining instructions.",
"type": "string"
}
},
"required": [
"type"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "address"
},
"address": {
"type": "string",
"description": "Full street address."
},
"venueName": {
"type": "string",
"description": "Venue name (may be empty)."
},
"latLng": {
"minItems": 2,
"maxItems": 2,
"type": "array",
"items": {
"type": "number"
},
"description": "[latitude, longitude]."
},
"placeId": {
"description": "Google Places place_id.",
"type": "string"
}
},
"required": [
"type",
"address",
"venueName",
"latLng"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "custom"
},
"address": {
"type": "string",
"minLength": 1,
"description": "Free-text address."
},
"venueName": {
"type": "string",
"minLength": 1,
"description": "Venue name."
}
},
"required": [
"type",
"address",
"venueName"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "toBeAnnounced"
}
},
"required": [
"type"
]
}
]
},
"keywords": {
"description": "Up to 10 unique search keywords, each 1-25 characters.",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 25
}
},
"classification": {
"description": "How the event is classified. subcategory must belong to category.",
"type": "object",
"properties": {
"type": {
"description": "Event type, e.g. concertOrPerformance.",
"type": "string",
"enum": [
"appearanceOrSigning",
"attraction",
"campTripOrRetreat",
"classTrainingOrWorkshop",
"concertOrPerformance",
"conference",
"convention",
"dinnerOrGala",
"festivalOrFair",
"gameOrCompetition",
"meetingOrNetworkingEvent",
"partyOrSocialGathering",
"raceOrEnduranceEvent",
"rally",
"screening",
"seminarOrTalk",
"tour",
"tournament",
"tradeShowConsumerShowOrExpo",
"other"
]
},
"category": {
"description": "Event category, e.g. music.",
"type": "string",
"enum": [
"autoBoatAndAir",
"businessAndProfessional",
"charityAndCauses",
"communityAndCulture",
"familyAndEducation",
"fashionAndBeauty",
"filmMediaAndEntertainment",
"foodAndDrink",
"governmentAndPolitics",
"healthAndWellness",
"hobbiesAndSpecialInterest",
"homeAndLifestyle",
"music",
"performingAndVisualArts",
"religionAndSpirituality",
"schoolActivities",
"scienceAndTechnology",
"seasonalAndHoliday",
"sportsAndFitness",
"travelAndOutdoor",
"other"
]
},
"subcategory": {
"description": "Subcategory within the category (e.g. jazz for music). Requires category.",
"type": "string"
}
}
},
"dates": {
"description": "Date operations: CREATE a new date range, or UPDATE an existing one by its _id.",
"minItems": 1,
"maxItems": 700,
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"operation": {
"type": "string",
"const": "CREATE"
},
"startDate": {
"type": "string",
"minLength": 1,
"description": "Start as an ISO 8601 date-time, e.g. 2026-11-01T09:00:00.000Z."
},
"endDate": {
"type": "string",
"minLength": 1,
"description": "End as an ISO 8601 date-time, e.g. 2026-11-01T09:00:00.000Z."
}
},
"required": [
"operation",
"startDate",
"endDate"
]
},
{
"type": "object",
"properties": {
"operation": {
"type": "string",
"const": "UPDATE"
},
"_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The date range id (the _id inside the event's dates) (24-character hex id)."
},
"startDate": {
"type": "string",
"minLength": 1,
"description": "New start as an ISO 8601 date-time, e.g. 2026-11-01T09:00:00.000Z."
},
"endDate": {
"type": "string",
"minLength": 1,
"description": "New end as an ISO 8601 date-time, e.g. 2026-11-01T09:00:00.000Z."
}
},
"required": [
"operation",
"_id",
"startDate",
"endDate"
]
}
]
}
},
"override_location": {
"description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region.",
"type": "string",
"enum": [
"AU",
"NZ",
"US",
"FJ",
"CA",
"GB",
"SG",
"DE",
"MY",
"MX"
]
}
},
"required": [
"event_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}