# Create an on-call schedule event

Create a new event in the given on-call schedule.

[endpoint]
base_url = "https://uptime.betterstack.com"
path = "/api/v2/on-calls/{schedule_id}/events"
method = "POST"

[[path_param]]
name = "schedule_id"
description = "The ID of the on-call schedule you want to create the event for. Use `default` to refer to the default on-call schedule for the team."
required = true
type = "string"

[[body_param]]
name = "starts_at"
description = '''
Start time of the event.
Must be today at 0:00 UTC or later.
'''
required = true
type = "date"

[[body_param]]
name = "ends_at"
description = "End time of the event."
required = true
type = "date"

[[body_param]]
name = "users"
description = "List of email addresses of users that will be on-call during this event."
required = true
type = "array"

[[body_param]]
name = "override"
description = "Whether this event is an override. Override events take precedence over regular scheduled events."
required = false
type = "boolean"

[[header]]
name = "Authorization"
description = "Bearer `$TOKEN`"
required = true
type = "string"

[/endpoint]

[responses]
[[response]]
status = 200
description = '''Event was created.'''
body = '''{
  "id": 12345678,
  "starts_at": "2025-01-01T09:00:00Z",
  "ends_at": "2025-01-01T17:00:00",
  "users": ["tomas@betterstack.com"],
  "override": false
}'''

[/responses]

#### Example cURL

[code-tabs]
```shell
[label Regular on-call event]
curl --request POST \
  --url "https://uptime.betterstack.com/api/v2/on-calls/default/events" \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "starts_at": "2025-01-01T09:00:00Z",
    "ends_at": "2025-01-01T17:00:00",
    "users": ["tomas@betterstack.com"]
  }'
```
```shell
[label Override event]
curl --request POST \
  --url "https://uptime.betterstack.com/api/v2/on-calls/default/events" \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "starts_at": "2025-01-01T09:00:00Z",
    "ends_at": "2025-01-01T17:00:00",
    "users": ["tomas@betterstack.com"],
    "override": true
  }'
```
[/code-tabs]