Skip to main content

Authentication

Alerta public API requests use API credentials created in the dashboard.

Sign in at https://app.alerta.encrisoft.com, open API Credentials, and generate or view the key and secret for the service that will send alerts.

Required Headers​

x-api-key: YOUR_API_KEY
x-api-secret: YOUR_API_SECRET
Content-Type: application/json

Keep credentials in a secret manager and avoid embedding them in browsers, mobile apps, or public repositories.

Base URL​

Use the production API base URL shown in your Alerta dashboard or onboarding material. The examples in this reference use https://api.usealerta.com.

Credential Rotation​

Create a replacement credential, update your sending service, verify delivery, and then revoke the old credential.

Example Authenticated Request​

curl --request POST \
  --url https://api.usealerta.com/v2/slack/send \
  --header "content-type: application/json" \
  --header "x-api-key: YOUR_API_KEY" \
  --header "x-api-secret: YOUR_API_SECRET" \
  --data '{
    "channel": "alerts",
    "message": "Database replication lag exceeded threshold."
  }'