---
source_url: "https://docs.withorb.com/api-reference/alert/create-customer-alert-by-external-id"
title: Create customer alert by external ID - Orb
mirrored_at: 2026-08-11T01:31:41.714Z
host: docs.withorb.com
cited_in_42a: true
mirror_canonical: "https://index.42a.ai/docs.withorb.com/api-reference/alert/create-customer-alert-by-external-id"
---

> **Original source:** https://docs.withorb.com/api-reference/alert/create-customer-alert-by-external-id

```
{
  "id": "<string>",
  "type": "\"usage_exceeded\", \"cost_exceeded\", \"credit_balance_depleted\", \"credit_balance_recovered\", or \"credit_balance_dropped\"",
  "created_at": "2023-11-07T05:31:56Z",
  "enabled": true,
  "thresholds": [
    {
      "value": 123
    }
  ],
  "customer": {
    "id": "<string>",
    "external_customer_id": "<string>"
  },
  "plan": {
    "id": "m2t5akQeh2obwxeU",
    "external_plan_id": "m2t5akQeh2obwxeU",
    "name": "Example plan",
    "plan_version": "<string>"
  },
  "subscription": {
    "id": "<string>"
  },
  "metric": {
    "id": "<string>"
  },
  "currency": "<string>",
  "license_type": {
    "id": "<string>"
  },
  "grouping_keys": [
    "<string>"
  ],
  "price_filters": [
    {
      "values": [
        "<string>"
      ]
    }
  ],
  "threshold_overrides": [
    {
      "group_values": [
        "<string>"
      ],
      "thresholds": [
        {
          "value": 123
        }
      ]
    }
  ],
  "balance_alert_status": [
    {
      "threshold_value": 123,
      "in_alert": true
    }
  ]
}
```