🗓️Calendars

Microsoft Outlook Calendars

Get All Calendars

GET https://api.pyas.io/microsoft/calendars

Gets all calendars that a user has access to.

Query Parameters

Name	Type	Description
accountId*	String	The user's Pyas account id. This is returned when you connect an account to Pyas.

Headers

Name	Type	Description
x-api-key*	String	API key

200: OK Successfully retrieved list of calendars

{
    "success": true,
    "data": {
        "calendars": [
            {
                "id": "some-calendar-id",
                "name": "Calendar",
                "color": "auto",
                "hexColor": "",
                "isDefaultCalendar": true,
                "changeKey": "some-key",
                "canShare": true,
                "canViewPrivateItems": true,
                "canEdit": true,
                "allowedOnlineMeetingProviders": [
                    "skypeForConsumer"
                ],
                "defaultOnlineMeetingProvider": "skypeForConsumer",
                "isTallyingResponses": true,
                "isRemovable": false,
                "owner": {
                    "name": "Jane Doe",
                    "address": "[e-mail]"
                }
            }
        ]
    }
}

401: Unauthorized Invalid/missing API key

{
    "error": "Unauthorized. Invalid API key."
}

400: Bad Request Missing account id

{
    "errors": [
        {
            "msg": "an account id is required.",
            "param": "accountId",
            "location": "query"
        }
    ]
}

404: Not Found Account Not Found. Invalid accountId

{
    "success": false,
    "error": "Invalid account id. Account Not Found",
    "code": 404
}

Get Calendar by ID

GET https://api.pyas.io/microsoft/calendars/{id}

Gets a calendar by id

Path Parameters

Name	Type	Description
{id}*	String	The id of the calendar to retrieve

Query Parameters

Name	Type	Description
accountId*	String	The user's Pyas account id. This is returned when you connect an account to Pyas

Headers

Name	Type	Description
x-api-key*	String	API key

200: OK Successfully retrieved the calendar

{
    "success": true,
    "calendar": {
        "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('[e-mail]')/calendars/$entity",
        "id": "some-calendar-id",
        "name": "Calendar",
        "color": "auto",
        "hexColor": "",
        "isDefaultCalendar": true,
        "changeKey": "some-key",
        "canShare": true,
        "canViewPrivateItems": true,
        "canEdit": true,
        "allowedOnlineMeetingProviders": [
            "skypeForConsumer"
        ],
        "defaultOnlineMeetingProvider": "skypeForConsumer",
        "isTallyingResponses": true,
        "isRemovable": false,
        "owner": {
            "name": "Jane Doe",
            "address": "[e-mail]"
        }
    }
}

404: Not Found Account Not Found. Invalid accountId

{
    "success": false,
    "error": "Invalid account id. Account Not Found",
    "code": 404
}

401: Unauthorized Invalid/missing API key

{
    "error": "Unauthorized. Invalid API key."
}

400: Bad Request Missing account id

{
    "errors": [
        {
            "msg": "an account id is required.",
            "param": "accountId",
            "location": "query"
        },
        {
            "msg": "account id must be a string",
            "param": "accountId",
            "location": "query"
        }
    ]
}

404: Not Found Calendar Not Found

{
    "success": false,
    "error": "Not Found",
    "code": 404
}