Create a new event

Creates a new event for the authenticated user's company.

Permission Requirements:

  • The authenticated user must be an employee (crew members cannot create events).
  • The created_by field is automatically set to the authenticated user.
  • The company field is automatically set from the user's company.

Auto-generated Fields:

  • User's timezone is automatically activated for the event.
  • Calendar associations are created if add_to_my_calendar is true.
  • Email and SMS notifications are sent to invitees automatically.
  • Calendar sync tasks are triggered for Google Calendar and Outlook integration.

Validation Rules:

  • The start time must be before the end time.
  • Event duration must be at least 15 minutes.
  • Start times before 7 AM are adjusted to 7 AM (unless all_day or any_time is true).
  • End times before 8 AM are adjusted to 8 AM (unless all_day or any_time is true).
  • Invitees must be valid user IDs within the company.

Field Restrictions:

  • The job field can only be set during creation and cannot be modified later.
  • Only non-recurring events can be created through this endpoint.
Language
Credentials
Header
Click Try It! to start a request and see the response here!