Submit a service request

POST

/v1/service-requests

Creates a Service Request for a person outside your organisation and links it to a meeting. Send meeting to have Calven book the meeting in the location room-requests calendar, which only a room request can do, or calendarEventId to link the request to an existing Calven calendar event, such as the one returned when you submitted the room request.

Request

Body Params application/jsonRequired

Examples

A room request that books a new meetingCatering for the meeting from an earlier submission

{
    "offeringId": "off-room-request-v1",
    "answers": [
        {
            "questionId": "q-room-size",
            "kind": "text",
            "value": "8 people"
        }
    ],
    "requester": {
        "name": "Alex Morgan",
        "email": "alex.morgan@example.com",
        "company": "Example Pty Ltd"
    },
    "meeting": {
        "start": "2026-11-01T23:00:00.000Z",
        "end": "2026-11-02T00:00:00.000Z",
        "subject": "Quarterly review with Example Pty Ltd",
        "attendees": [
            {
                "email": "sam.lee@example.com",
                "name": "Sam Lee"
            }
        ]
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

A room request that books a new meetingCatering for the meeting from an earlier submission

curl --location 'https://api.calven.com/v1/service-requests' \
--header 'Content-Type: application/json' \
--data-raw '{
    "offeringId": "off-room-request-v1",
    "answers": [
        {
            "questionId": "q-room-size",
            "kind": "text",
            "value": "8 people"
        }
    ],
    "requester": {
        "name": "Alex Morgan",
        "email": "alex.morgan@example.com",
        "company": "Example Pty Ltd"
    },
    "meeting": {
        "start": "2026-11-01T23:00:00.000Z",
        "end": "2026-11-02T00:00:00.000Z",
        "subject": "Quarterly review with Example Pty Ltd",
        "attendees": [
            {
                "email": "sam.lee@example.com",
                "name": "Sam Lee"
            }
        ]
    }
}'

Responses

🟢201Created

application/json

Bodyapplication/json

Example

{
    "serviceRequestId": "sr-7f3a",
    "calendarEventId": "ce-91c2"
}

🟠401Unauthorized

Modified at 2026-10-16 03:07:55

Service Offering

Service Request