Explore documentation
  1. Welcome to Errors
    1. JavaScript tag
  2. Collecting errors
    1. Integrating using an AI prompt
    2. Sentry SDK
  3. Using the product
    1. Exception grouping
    2. AI prompt
    3. Releases
    4. Uploading source maps
    5. Spike protection
  4. Integrations
    1. Reporting incidents
    2. Slack
    3. Microsoft Teams
    4. Linear
    5. Jira
    6. GitHub
    7. Outgoing webhooks
  5. Errors API
    1. Getting an API token
    2. Applications API
    3. Application groups API
      1. List all groups GET
      2. Get a single group GET
      3. Create a group POST
      4. Update a group PATCH
      5. Remove a group DELETE
      6. List applications in a group GET
    4. Releases API

Create a group

Creates a new application group.

POST https://errors.betterstack.com/api/v1/application-groups

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
required string

application/json

Body parameters

team_name
string

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

name
required string

Application group name. Must be unique within your team.

platform
string

Platform type for the application group. Automatically set to errors.

201

Returns the newly created application group.

Response body

{
  "data": {
    "id": "5678",
    "type": "application_group",
    "attributes": {
      "name": "new-production-group",
      "created_at": "2025-01-15T10:25:00.000Z",
      "updated_at": "2025-01-15T10:25:00.000Z",
      "sort_index": null,
      "team_name": "example-team"
    }
  }
}
401

Unauthorized

Response body

{
  "errors": "Invalid authentication"
}
400

Bad Request - Missing Required Attributes

Response body

{
  "errors": "Sorry, you are missing some required attributes",
  "required_attributes": [
    "name"
  ]
}
422

Unprocessable Entity - Validation Errors

Response body

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

Example cURL

Example
curl --request POST \
  --url https://errors.betterstack.com/api/v1/application-groups \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "new-production-group"
  }'


Previous article

Get a single group

Next article

Update a group