Shares

Create Share

Endpoint for our Customize Once and Share feature. This allows you to customize events for a specific invitee without needing to make an entirely new event type. This feature is only available for one-on-one event types. Note: Any parameter which is not provided in the request body will be copied from the target event type.

<Info title="Required scopes"> > `shares:write` </Info>
post/shares

Request

  • Base URL: https://api.calendly.com
  • URL: https://api.calendly.com/shares
  • Auth: HTTP bearer

Request body

event_typestring uri required
namestring
durationinteger

Must be one of the provided duration options. If duration options aren't provided then duration must be one of the duration options inherited from the event type.

duration_optionsinteger[]

A maximum of 4 unique options is allowed. Each option must be >= 1 and <= 720.

period_type'available_moving' | 'moving' | 'fixed' | 'unlimited'
start_datestring date

is required when period_type is 'fixed' Format: YYYY-MM-DD

end_datestring date

is required when period_type is 'fixed' Format: YYYY-MM-DD

max_booking_timeinteger

is required when period_type is 'moving' or 'available_moving'

hide_locationboolean

determines if a location is hidden until invitee books a spot, only respected when there is a single custom location configured

Response

Created

Changes

No recorded changes to this operation across all 1 revision of this API.