# Create status page section

Returns a newly created status page section.

[endpoint]
base_url = "https://uptime.betterstack.com"
path = "/api/v2/status-pages/{status_page_id}/sections"
method = "POST"

[[path_param]]
name = "status_page_id"
description = "The ID of your status page"
required = true
type = "string"

[[body_param]]
name = "name"
description = "The name of the section. Leave blank to hide the section header."
required = false
type = "string"

[[body_param]]
name = "position"
description = "The position of this resource on your status page, indexed from zero. If you don't specify a `position`, we add the resource to the end of the status page. When you specify a `position` of an existing resource, we add the resource to this position and shift resources below to accommodate."
required = false
type = "integer"

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

[[header]]
name = "Content_Type"
description = "application/json"
required = false
type = "string"
[/endpoint]

[responses]
[[response]]
status = 201
description = ''''''
body = '''{
  "id": "12345",
  "type": "status_page_section",
  "attributes": {
    "name": "EU Datacenter",
    "position": 0,
    "status_page_id": 123456789
  }
}'''
[/responses]

#### Example cURL 

```shell
[label Example]
curl --request POST \
  --url https://uptime.betterstack.com/api/v2/status-pages/123456789/sections \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
	"name": "EU Datacenter",
	"position": 0
}'
```

[info]
#### Looking for the details of a specific parameter?
Explore [the list of all status page sections API parameters](https://betterstack.com/docs/uptime/api/status-pages-sections-api-response-params/)
[/info]