Explore documentation
  1. Welcome to Errors 👋
  2. Collecting errors
    1. Integrating using an AI prompt
    2. Sentry SDK
  3. Using the product
    1. Exception grouping
    2. Fix with AI
    3. Releases
  4. Integrations
    1. Reporting incidents
    2. Slack
    3. Microsoft Teams
    4. Linear
    5. Jira
  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 PUT
      5. Remove a group DELETE
      6. List applications in a group GET

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

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