Explore documentation
  1. Welcome to Telemetry👋
  2. Quick start guide
  3. Ingesting data
    1. Better Stack collector
    2. Vector
    3. OpenTelemetry
    4. Ingesting via HTTP API
    5. Ingesting metrics
    6. Ingesting logs
    7. Migrating to Better Stack
  4. Telemetry API
    1. Getting an API token
    2. Sources
      1. Sources API
      2. Source groups API
        1. List all source groups GET
        2. Get a single source group GET
        3. Create a source group GET
        4. Update a source group PATCH
        5. Remove a source group DELETE
    3. Metrics API
    4. Query API
  5. Using the product
    1. Wide events vs. time series
    2. Transforming ingested data
    3. Querying data
    4. Alerts

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
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"
}'

Previous article

Get a single source group

Next article

Update a source group