Explore documentation

Create an on-call calendar

Create a new on-call calendar. Returns either the new calendar, or validation errors.

POST https://uptime.betterstack.com/api/v2/on-calls

Headers

Authorization
required string

Body parameters

name
required string
team_name
string
200

Response body

{
  "id": "56",
  "type": "on_call_calendar",
  "attributes": {
    "name": "My New Calendar",
    "default_calendar": false,
    "team_name": "Backend Team"
  },
  "relationships": {
    "on_call_users": {
      "data": [

      ]
    }
  }
}
422

Response body

{
  "errors": {
    "name": [
      "can't be blank"
    ]
  }
}

Example cURL

Example
curl --request POST \
  --url https://uptime.betterstack.com/api/v2/on-calls \
  --header "Authorization: Bearer $TOKEN"
  --data '{"name": "My New Calendar"}'