Skip to Content

Limits

The size and range limits on every request, and what happens when one is passed.

Every text field, list and number you send has a limit. They are generous on purpose: a real venue should never meet one. The same field has the same limit on every endpoint.

WhatLimitField
Event or series title200 characterstitle
Description10,000 charactersdescription
Place name200 characterslocation_name
Address500 characterslocation_address
Price note200 charactersprice_note
Links2,048 characters, https:// onlyonline_url, cover_image_url
Webhook endpoint URL2,048 charactersurl on webhook endpoints
Event slug100 characters: lowercase letters, digits and single hyphensslug
Timezone64 characters, an IANA name such as America/Detroittimezone
Capacity1 to 1,000,000, or nullcapacity
Plus-ones an event allows0 to 100max_guests
Plus-ones on one RSVP0 to 100, and never more than the event's max_guestsguests
Series date length1 to 10,080 minutes (one week)duration_minutes
Custom questions per event100, or fewer on your planfields
Question key1 to 64 lowercase letters, digits or underscores, unique within the eventfields[].key
Question text200 charactersfields[].label
Choices on a pick-one question1 to 100, each up to 200 characters, no repeatsfields[].options
Answers100 keys, 100,000 characters in all as JSONanswers
One answerText up to 500 characters (5,000 for a long-answer question), a number, true or false, or nullanswers.<key>
Guest name200 charactersname
Email address320 characters. Spaces around it are removed; case is kept but ignored when matchingemail
Webhook event types1 or more, no repeatsevents on webhook endpoints
Page size1 to 100limit
Idempotency key255 charactersIdempotency-Key header

A request over a limit answers 400 validation_failed, and errors[] names each field by its dotted path, such as title, fields.2.key or answers.deck. See errors.

online_url and cover_image_url must start with https://. Guests open them from your page and the hosted page, and an http:// link would load without encryption or be blocked as mixed content. Webhook endpoint URLs follow their own rules.

Custom questions and answers

  • A question's key is what its answer is stored under, so it never changes: lowercase letters, digits and underscores, unique within the event. The dashboard makes one from the question text ("Favorite deck?" becomes favorite_deck).
  • A select question needs at least one choice, and no choice may appear twice.
  • answers is an object keyed by question key. Each value is text, a number, true or false (or null for no answer); lists are not accepted. Text is checked against its question: up to 500 characters for a short answer, 5,000 for a long answer.

Plans

Some limits are lower on smaller plans: custom questions per event (Free 5, Starter 20), API keys, webhook endpoints and active series. Going over a plan limit answers 403 plan_limit instead. See plans and limits.

Limits only grow

Under versioning rules, a limit on /v1 can be raised but never lowered, and a field's format never gets stricter.

On this page