5 minute setup

Quickstart

Send your first alert in under 5 minutes. No credit card required.

1

Create an account

Sign up for a free Talarius account. You'll get 10 trial credits to test the service.

Create Free Account
2

Create a project

Projects are containers for your alerts. Create one project per application or environment.

Tip

Use separate projects for production and staging environments to keep alerts organized.

3

Add a destination

Connect your project to Telegram, Discord, or Slack. Each project has one destination.

4

Get your API key

Copy your project's API key from the dashboard. Keep it secure and never expose it in client-side code.

tk_live_a1b2c3d4e5f6... Your API key (example)

Security warning

Store your API key in environment variables. Never commit it to version control or expose it in frontend code.

5

Send your first alert

Make a POST request to the /alerts endpoint.

curl
curl -X POST https://v1.talarius.io/alerts \
  -H "X-API-Key: tk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"title": "Hello from Talarius!", "body": "Your first alert is working."}'
Node.js
const response = await fetch('https://v1.talarius.io/alerts', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.TALARIUS_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Server Alert',
    body: 'CPU usage exceeded 90%',
    priority: 'high',
  }),
});

const result = await response.json();
console.log(result.alertId);
Python
import requests

response = requests.post(
    'https://v1.talarius.io/alerts',
    headers={
        'X-API-Key': os.environ['TALARIUS_API_KEY'],
        'Content-Type': 'application/json',
    },
    json={
        'title': 'Backup Complete',
        'body': 'Database backup finished successfully',
    },
)

print(response.json()['alertId'])

Check your destination

Your alert should appear in your Telegram, Discord, or Slack within seconds. You can also view delivery status in your dashboard.

You're all set!

Your Talarius integration is ready. Explore the full API reference for more options.