Servers Playground How we check Submit a server

Humanitix MCP by usefulapi

Working · 606 ms

io.usefulapi/humanitixv1.17.0 Domain verified

Read Humanitix events, orders, tickets and live check-in counts, and check tickets in or out.

Entertainment & Games

Source Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://humanitix.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

humanitix_check_in_ticket

Mark a ticket as checked in at the door. Returns any scanning messages configured for that ticket. Undo with humanitix_check_out_ticket. Humanitix: POST /v1/events/{eventId}/tickets/{ticketId}/check-in.

event_idstring, required

The event id (24-character hex id).

ticket_idstring, required

The ticket id (24-character hex id).

override_locationstring

Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Humanitix MCP by usefulapi MCP server | mcptry

Tools (15)

humanitix_check_in_ticket

destructive

Argument	Type	Description
event_id*	string	The event id (24-character hex id).
ticket_id*	string	The ticket id (24-character hex id).
override_location	string	Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event_id",
    "ticket_id"
  ],
  "properties": {
    "event_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The event id (24-character hex id)."
    },
    "ticket_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The ticket id (24-character hex id)."
    },
    "override_location": {
      "enum": [
        "AU",
        "NZ",
        "US",
        "FJ",
        "CA",
        "GB",
        "SG",
        "DE",
        "MY",
        "MX"
      ],
      "type": "string",
      "description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
    }
  }
}

humanitix_check_out_ticket

Mark a checked-in ticket as checked out (e.g. to undo a mistaken check-in or track re-entry). Humanitix: POST /v1/events/{eventId}/tickets/{ticketId}/check-out.

destructive

Argument	Type	Description
event_id*	string	The event id (24-character hex id).
ticket_id*	string	The ticket id (24-character hex id).
override_location	string	Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event_id",
    "ticket_id"
  ],
  "properties": {
    "event_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The event id (24-character hex id)."
    },
    "ticket_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The ticket id (24-character hex id)."
    },
    "override_location": {
      "enum": [
        "AU",
        "NZ",
        "US",
        "FJ",
        "CA",
        "GB",
        "SG",
        "DE",
        "MY",
        "MX"
      ],
      "type": "string",
      "description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
    }
  }
}

humanitix_create_event

Create a base event (name, description, timezone, one or more date ranges, location, keywords, classification). Ticket types are then set up in the Humanitix console. Requires a special permission Humanitix activates on your account (403 otherwise). Humanitix: POST /v1/events.

destructive

Argument	Type	Description
name*	string	Event name.
dates*	array	One or more date ranges (1-700).
keywords	array	Up to 10 unique search keywords, each 1-25 characters.
timezone*	string	IANA timezone, e.g. Australia/Sydney or Pacific/Auckland.
description	string	Event description.
classification	object	How the event is classified. subcategory must belong to category.
event_location	any	Where the event happens: online, address (geocoded), custom (free text) or toBeAnnounced.
override_location	string

humanitix_get_check_in_count

How many attendees have checked in for one date of an event, in total and per ticket type (ticket types with sales only, most check-ins first). BETA endpoint. Humanitix: GET /v1/events/{eventId}/check-in-count.

read-only

Argument	Type	Description
event_id*	string	The event id (24-character hex id).
event_date_id*	string	The event date id (24-character hex id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event_id",
    "event_date_id"
  ],
  "properties": {
    "event_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The event id (24-character hex id)."
    },
    "event_date_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The event date id (24-character hex id)."
    }
  }
}

humanitix_get_event

Fetch one event: name, description, URL, dates (each date's _id is the event_date_id other tools take), ticket types, packaged tickets, pricing, location, capacity and publish state. Humanitix: GET /v1/events/{eventId}.

read-only

Argument	Type	Description
event_id*	string	The event id (24-character hex id).
override_location	string	Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event_id"
  ],
  "properties": {
    "event_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The event id (24-character hex id)."
    },
    "override_location": {
      "enum": [
        "AU",
        "NZ",
        "US",
        "FJ",
        "CA",
        "GB",
        "SG",
        "DE",
        "MY",
        "MX"
      ],
      "type": "string",
      "description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
    }
  }
}

humanitix_get_order

Fetch one order of an event, with its totals breakdown, answers to checkout questions and buyer details. Humanitix: GET /v1/events/{eventId}/orders/{orderId}.

read-only

Argument	Type	Description
event_id*	string	The event id (24-character hex id).
order_id*	string	The order id (24-character hex id).
override_location	string	Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event_id",
    "order_id"
  ],
  "properties": {
    "event_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The event id (24-character hex id)."
    },
    "order_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The order id (24-character hex id)."
    },
    "override_location": {
      "enum": [
        "AU",
        "NZ",
        "US",
        "FJ",
        "CA",
        "GB",
        "SG",
        "DE",
        "MY",
        "MX"
      ],
      "type": "string",
      "description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
    }
  }
}

humanitix_get_tag

Fetch one tag by id. Humanitix: GET /v1/tags/{tagId}.

read-only

Argument	Type	Description
tag_id*	string	The tag id (24-character hex id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "tag_id"
  ],
  "properties": {
    "tag_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The tag id (24-character hex id)."
    }
  }
}

humanitix_get_ticket

Fetch one ticket of an event, including its check-in history and any swap history. Humanitix: GET /v1/events/{eventId}/tickets/{ticketId}.

read-only

Argument	Type	Description
event_id*	string	The event id (24-character hex id).
ticket_id*	string	The ticket id (24-character hex id).
override_location	string	Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event_id",
    "ticket_id"
  ],
  "properties": {
    "event_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The event id (24-character hex id)."
    },
    "ticket_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The ticket id (24-character hex id)."
    },
    "override_location": {
      "enum": [
        "AU",
        "NZ",
        "US",
        "FJ",
        "CA",
        "GB",
        "SG",
        "DE",
        "MY",
        "MX"
      ],
      "type": "string",
      "description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
    }
  }
}

humanitix_list_events

List your events, newest first, with dates, ticket types, pricing and capacity. Filter to upcoming events or events changed since a date. Paged (total/page/pageSize in the response). Humanitix: GET /v1/events.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1. Defaults to 1.
since	string	Only results created/updated since this ISO 8601 date-time, e.g. 2026-01-01T00:00:00.000Z.
page_size	integer	Results per page, 1-100 (API default 100).
in_future_only	boolean	Only events whose end date is in the future.
override_location	string	Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, starting at 1. Defaults to 1."
    },
    "since": {
      "type": "string",
      "description": "Only results created/updated since this ISO 8601 date-time, e.g. 2026-01-01T00:00:00.000Z."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (API default 100)."
    },
    "in_future_only": {
      "type": "boolean",
      "description": "Only events whose end date is in the future."
    },
    "override_location": {
      "enum": [
        "AU",
        "NZ",
        "US",
        "FJ",
        "CA",
        "GB",
        "SG",
        "DE",
        "MY",
        "MX"
      ],
      "type": "string",
      "description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
    }
  }
}

humanitix_list_global_event_dates

List individual event dates from across the platform — one row per date — with the public on-sale status of every ticket type. Requires a special permission Humanitix activates on your account (403 otherwise). Paged. Humanitix: GET /v1/global/event-dates.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1. Defaults to 1.
type	string	Event type, e.g. concertOrPerformance.
category	string	Event category, e.g. music.
page_size	integer	Results per page, 1-100 (API default 100).
subcategory	string	Subcategory within the category (e.g. jazz for music). Requires category.
override_location	string	Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region.
with_artists_only	boolean	Only events that list artists.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, starting at 1. Defaults to 1."
    },
    "type": {
      "enum": [
        "appearanceOrSigning",
        "attraction",
        "campTripOrRetreat",
        "classTrainingOrWorkshop",
        "concertOrPerformance",
        "conference",
        "convention",
        "dinnerOrGala",
        "festivalOrFair",
        "gameOrCompetition",
        "meetingOrNetworkingEvent",
        "partyOrSocialGathering",
        "raceOrEnduranceEvent",
        "rally",
        "screening",
        "seminarOrTalk",
        "tour",
        "tournament",
        "tradeShowConsumerShowOrExpo",
        "other"
      ],
      "type": "string",
      "description": "Event type, e.g. concertOrPerformance."
    },
    "category": {
      "enum": [
        "autoBoatAndAir",
        "businessAndProfessional",
        "charityAndCauses",
        "communityAndCulture",
        "familyAndEducation",
        "fashionAndBeauty",
        "filmMediaAndEntertainment",
        "foodAndDrink",
        "governmentAndPolitics",
        "healthAndWellness",
        "hobbiesAndSpecialInterest",
        "homeAndLifestyle",
        "music",
        "performingAndVisualArts",
        "religionAndSpirituality",
        "schoolActivities",
        "scienceAndTechnology",
        "seasonalAndHoliday",
        "sportsAndFitness",
        "travelAndOutdoor",
        "other"
      ],
      "type": "string",
      "description": "Event category, e.g. music."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (API default 100)."
    },
    "subcategory": {
      "type": "string",
      "description": "Subcategory within the category (e.g. jazz for music). Requires category."
    },
    "override_location": {
      "enum": [
        "AU",
        "NZ",
        "US",
        "FJ",
        "CA",
        "GB",
        "SG",
        "DE",
        "MY",
        "MX"
      ],
      "type": "string",
      "description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
    },
    "with_artists_only": {
      "type": "boolean",
      "description": "Only events that list artists."
    }
  }
}

humanitix_list_global_events

List public events from across the whole Humanitix platform, filterable by type, category and subcategory. Requires a special permission Humanitix activates on your account (403 otherwise). Paged. Humanitix: GET /v1/global/events.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1. Defaults to 1.
type	string	Event type, e.g. concertOrPerformance.
category	string	Event category, e.g. music.
page_size	integer	Results per page, 1-100 (API default 100).
subcategory	string	Subcategory within the category (e.g. jazz for music). Requires category.
override_location	string	Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region.
with_artists_only	boolean	Only events that list artists.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, starting at 1. Defaults to 1."
    },
    "type": {
      "enum": [
        "appearanceOrSigning",
        "attraction",
        "campTripOrRetreat",
        "classTrainingOrWorkshop",
        "concertOrPerformance",
        "conference",
        "convention",
        "dinnerOrGala",
        "festivalOrFair",
        "gameOrCompetition",
        "meetingOrNetworkingEvent",
        "partyOrSocialGathering",
        "raceOrEnduranceEvent",
        "rally",
        "screening",
        "seminarOrTalk",
        "tour",
        "tournament",
        "tradeShowConsumerShowOrExpo",
        "other"
      ],
      "type": "string",
      "description": "Event type, e.g. concertOrPerformance."
    },
    "category": {
      "enum": [
        "autoBoatAndAir",
        "businessAndProfessional",
        "charityAndCauses",
        "communityAndCulture",
        "familyAndEducation",
        "fashionAndBeauty",
        "filmMediaAndEntertainment",
        "foodAndDrink",
        "governmentAndPolitics",
        "healthAndWellness",
        "hobbiesAndSpecialInterest",
        "homeAndLifestyle",
        "music",
        "performingAndVisualArts",
        "religionAndSpirituality",
        "schoolActivities",
        "scienceAndTechnology",
        "seasonalAndHoliday",
        "sportsAndFitness",
        "travelAndOutdoor",
        "other"
      ],
      "type": "string",
      "description": "Event category, e.g. music."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (API default 100)."
    },
    "subcategory": {
      "type": "string",
      "description": "Subcategory within the category (e.g. jazz for music). Requires category."
    },
    "override_location": {
      "enum": [
        "AU",
        "NZ",
        "US",
        "FJ",
        "CA",
        "GB",
        "SG",
        "DE",
        "MY",
        "MX"
      ],
      "type": "string",
      "description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
    },
    "with_artists_only": {
      "type": "boolean",
      "description": "Only events that list artists."
    }
  }
}

humanitix_list_orders

List the orders for an event (optionally one date of it): buyer name/email, financial status, totals, discounts, payment type and sales channel. Paged. Humanitix: GET /v1/events/{eventId}/orders.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1. Defaults to 1.
since	string	Only results created/updated since this ISO 8601 date-time, e.g. 2026-01-01T00:00:00.000Z.
event_id*	string	The event id (24-character hex id).
page_size	integer	Results per page, 1-100 (API default 100).
event_date_id	string	The event date id (24-character hex id).
override_location	string	Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, starting at 1. Defaults to 1."
    },
    "since": {
      "type": "string",
      "description": "Only results created/updated since this ISO 8601 date-time, e.g. 2026-01-01T00:00:00.000Z."
    },
    "event_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The event id (24-character hex id)."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (API default 100)."
    },
    "event_date_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The event date id (24-character hex id)."
    },
    "override_location": {
      "enum": [
        "AU",
        "NZ",
        "US",
        "FJ",
        "CA",
        "GB",
        "SG",
        "DE",
        "MY",
        "MX"
      ],
      "type": "string",
      "description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
    }
  }
}

humanitix_list_tags

List the tags you use to group events (events carry them in tagIds). Paged. Humanitix: GET /v1/tags.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1. Defaults to 1.
page_size	integer	Results per page, 1-100 (API default 100).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, starting at 1. Defaults to 1."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (API default 100)."
    }
  }
}

humanitix_list_tickets

List the tickets (attendees) for an event, optionally one date of it and complete or cancelled only: attendee name, ticket type, price, check-in state and seating. Paged. Humanitix: GET /v1/events/{eventId}/tickets.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1. Defaults to 1.
since	string	Only results created/updated since this ISO 8601 date-time, e.g. 2026-01-01T00:00:00.000Z.
status	string	Only tickets with this status.
event_id*	string	The event id (24-character hex id).
page_size	integer	Results per page, 1-100 (API default 100).
event_date_id	string	The event date id (24-character hex id).
override_location	string	Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, starting at 1. Defaults to 1."
    },
    "since": {
      "type": "string",
      "description": "Only results created/updated since this ISO 8601 date-time, e.g. 2026-01-01T00:00:00.000Z."
    },
    "status": {
      "enum": [
        "complete",
        "cancelled"
      ],
      "type": "string",
      "description": "Only tickets with this status."
    },
    "event_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The event id (24-character hex id)."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (API default 100)."
    },
    "event_date_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "The event date id (24-character hex id)."
    },
    "override_location": {
      "enum": [
        "AU",
        "NZ",
        "US",
        "FJ",
        "CA",
        "GB",
        "SG",
        "DE",
        "MY",
        "MX"
      ],
      "type": "string",
      "description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
    }
  }
}

humanitix_update_event

Update an event's name, description, timezone, location, keywords or classification, and add or reschedule dates (date operations CREATE and UPDATE; deleting dates is not exposed). Only fields you pass are sent. Requires a special permission Humanitix activates on your account (403 otherwise). Humanitix: PATCH /v1/events/{eventId}.

destructive

Argument	Type	Description
name	string	New event name.
dates	array	Date operations: CREATE a new date range, or UPDATE an existing one by its _id.
event_id*	string	The event id (24-character hex id).
keywords	array	Up to 10 unique search keywords, each 1-25 characters.
timezone	string	New IANA timezone.
description	string	New description.
classification	object	How the event is classified. subcategory must belong to category.
event_location	any	Where the event happens: online, address (geocoded), custom (free text) or toBeAnnounced.

Input schema (JSON)

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

Input schema (JSON)

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