Skip to main content
POST
/
v2
/
organizations
/
{orgId}
/
routing-forms
/
{routingFormId}
/
responses
Create routing form response and get available slots
curl --request POST \
  --url https://api.cal.com/v2/organizations/{orgId}/routing-forms/{routingFormId}/responses \
  --header 'Authorization: <authorization>'
{
  "status": "success",
  "data": {
    "eventTypeId": 123,
    "routing": {
      "eventTypeId": 123,
      "routing": {
        "teamMemberIds": [
          101,
          102
        ],
        "teamMemberEmail": "john.doe@example.com",
        "skipContactOwner": true
      }
    },
    "routingCustomMessage": "This is a custom message.",
    "routingExternalRedirectUrl": "https://example.com/",
    "slots": {}
  }
}

Headers

​
Authorization
string
required

value must be Bearer <token> where <token> is api key prefixed with cal_

Path Parameters

​
orgId
number
required
​
routingFormId
string
required

Query Parameters

​
start
string
required
Time starting from which available slots should be checked.

  Must be in UTC timezone as ISO 8601 datestring.
  
  You can pass date without hours which defaults to start of day or specify hours:
  2024-08-13 (will have hours 00:00:00 aka at very beginning of the date) or you can specify hours manually like 2024-08-13T09:00:00Z
​
end
string
required
Time until which available slots should be checked.
  
  Must be in UTC timezone as ISO 8601 datestring.
  
  You can pass date without hours which defaults to end of day or specify hours:
  2024-08-20 (will have hours 23:59:59 aka at the very end of the date) or you can specify hours manually like 2024-08-20T18:00:00Z
​
timeZone
string

Time zone in which the available slots should be returned. Defaults to UTC.

​
duration
number

If event type has multiple possible durations then you can specify the desired duration here. Also, if you are fetching slots for a dynamic event then you can specify the duration her which defaults to 30, meaning that returned slots will be each 30 minutes long.

​
format
enum<string>

Format of slot times in response. Use 'range' to get start and end times.

Available options:
range,
time
​
bookingUidToReschedule
string

The unique identifier of the booking being rescheduled. When provided will ensure that the original booking time appears within the returned available slots when rescheduling.

​
queueResponse
boolean

Whether to queue the form response.

Response

201 - application/json
​
status
enum<string>
required
Available options:
success,
error
Example:

"success"

​
data
object
required