Event Creation URLs

WhenMeet allows you to prefill event creation forms using URL parameters. This feature is useful for creating quick links to event creation forms with predefined settings.

Basic Usage

You can create URLs that automatically populate the event creation form with specific values. This is particularly useful for:

• Creating quick links for recurring events
• Sharing event templates with your team
• Integrating with calendar applications
• Creating event invitations with predefined times

URL Parameters

Basic Event Details

Time Slots

Examples

Simple Event

/events/new?title=Team%20Meeting&description=Weekly%20sync

Event with Time Slots

/events/new?title=Team%20Meeting&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z&slots=2024-01-16T14:00:00Z,2024-01-16T15:00:00Z&slotLength=60

Complete Event Template

/events/new?title=Project%20Kickoff&description=Initial%20project%20meeting&slots=2024-01-15T09:00:00Z,2024-01-15T10:30:00Z&slots=2024-01-15T14:00:00Z,2024-01-15T15:30:00Z&slotLength=90

Time Slot Format

Time slots must be provided in ISO 8601 format with the following requirements:

• Format: YYYY-MM-DDTHH:mm:ssZ
• Duration: Minimum 30 minutes
• Future dates: All slots must be in the future
• No overlap: Slots cannot overlap with each other

Valid Examples

2024-01-15T09:00:00Z,2024-01-15T10:00:00Z
2024-01-16T14:30:00Z,2024-01-16T16:00:00Z

Invalid Examples

2024-01-15T09:00:00Z,2024-01-15T09:15:00Z  # Too short (15 minutes)
2024-01-15T10:00:00Z,2024-01-15T09:00:00Z  # End before start
2023-01-15T09:00:00Z,2023-01-15T10:00:00Z  # Past date

Multiple Time Slots

To specify multiple time slots, use multiple slots parameters:

/events/new?title=Team%20Meeting&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z&slots=2024-01-16T14:00:00Z,2024-01-16T15:00:00Z&slots=2024-01-17T16:00:00Z,2024-01-17T17:00:00Z

URL Encoding

When creating URLs manually, remember to URL-encode special characters:

Example

Original: Team Meeting, Weekly Sync
Encoded: Team%20Meeting%2C%20Weekly%20Sync

Integration Examples

Calendar Applications

Many calendar applications support URL parameters for event creation. You can use WhenMeet URLs as the event URL:

Calendar Event URL: https://whentomeet.io/events/new?title=Team%20Meeting&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z

Email Templates

Include WhenMeet URLs in your email templates for quick event creation:

<a
  href="https://whentomeet.io/events/new?title=Team%20Meeting&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z"
>
  Create Team Meeting
</a>

Slack/Teams Integration

Use WhenMeet URLs in your team communication tools:

/events/new?title=Daily%20Standup&slots=2024-01-15T09:00:00Z,2024-01-15T09:15:00Z&slotLength=15

Best Practices

1. Keep URLs short: Only include necessary parameters
2. Use meaningful titles: Make the event purpose clear
3. Provide multiple time slots: Give participants options
4. Set appropriate duration: Consider the meeting type
5. Test your URLs: Ensure they work as expected
6. Mobile optimization: For the best mobile experience, add WhenToMeet to your home screen for quick access to event creation

Limitations

• Maximum slot duration: 24 hours
• Minimum slot duration: 30 minutes
• Maximum slots per event: No limit (but consider usability)
• All slots must be in the future
• Slots cannot overlap

Troubleshooting

Common Issues

1. Invalid date format: Ensure dates are in ISO 8601 format
2. Past dates: All slots must be in the future
3. Overlapping slots: Slots cannot overlap
4. Short duration: Slots must be at least 30 minutes
5. URL encoding: Special characters must be properly encoded

Error Messages

• "Invalid slot format": Check the date format
• "Slot duration must be at least 30 minutes": Increase slot duration
• "Time slots cannot overlap": Adjust slot times
• "All time slots must be in the future": Use future dates