Create a source group

Returns either a newly created source group, or validation errors.

POST https://telemetry.betterstack.com/api/v1/source-groups

Headers

Authorization

required string

Bearer $TOKEN

Content_Type

string

application/json

Body parameters

team_name

string

Required if using global API token to specify the team which should own the resource

name

string

The name of the group that you can see in the dashboard.

sort_index

integer

Set sort_index to specify how to sort your source groups.

201

Returns newly created source group

Response body

{
  "data": {
    "id": "95251342",
    "type": "source_group",
    "attributes": {
      "name": "Backend sources",
      "sort_index": null,
      "created_at": "2025-06-30T17:43:12.192Z",
      "updated_at": "2020-06-30T17:43:12.192Z",
      "team_name": "Test team"
    }
  }
}

Example cURL

Example

Copied!

curl --request POST \
  --url https://telemetry.betterstack.com/api/v1/source-groups \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Backend sources"
}'

Explore documentation

Create a source group

Example cURL