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.
| What | Limit | Field |
|---|---|---|
| Event or series title | 200 characters | title |
| Description | 10,000 characters | description |
| Place name | 200 characters | location_name |
| Address | 500 characters | location_address |
| Price note | 200 characters | price_note |
| Links | 2,048 characters, https:// only | online_url, cover_image_url |
| Webhook endpoint URL | 2,048 characters | url on webhook endpoints |
| Event slug | 100 characters: lowercase letters, digits and single hyphens | slug |
| Timezone | 64 characters, an IANA name such as America/Detroit | timezone |
| Capacity | 1 to 1,000,000, or null | capacity |
| Plus-ones an event allows | 0 to 100 | max_guests |
| Plus-ones on one RSVP | 0 to 100, and never more than the event's max_guests | guests |
| Series date length | 1 to 10,080 minutes (one week) | duration_minutes |
| Custom questions per event | 100, or fewer on your plan | fields |
| Question key | 1 to 64 lowercase letters, digits or underscores, unique within the event | fields[].key |
| Question text | 200 characters | fields[].label |
| Choices on a pick-one question | 1 to 100, each up to 200 characters, no repeats | fields[].options |
| Answers | 100 keys, 100,000 characters in all as JSON | answers |
| One answer | Text up to 500 characters (5,000 for a long-answer question), a number, true or false, or null | answers.<key> |
| Guest name | 200 characters | name |
| Email address | 320 characters. Spaces around it are removed; case is kept but ignored when matching | email |
| Webhook event types | 1 or more, no repeats | events on webhook endpoints |
| Page size | 1 to 100 | limit |
| Idempotency key | 255 characters | Idempotency-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.
Links are https:// only
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
keyis 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?" becomesfavorite_deck). - A
selectquestion needs at least one choice, and no choice may appear twice. answersis an object keyed by questionkey. Each value is text, a number,trueorfalse(ornullfor 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.