Docs · Integrations

Connect your existing tools.

Every integration lives under Settings → Integrations, is managed by org admins, and is configured per workspace. Slack, on-call, ticketing, and the API are available on Control and Enterprise.

01 · Slack

Connect Slack in one click.

The fastest way is Add to Slack: a single approval that wires both channel alerts and 1:1 direct messages, and you pick the channel right in Slack. Prefer to wire the channel by hand? Use an Incoming Webhook instead. Either way, trueno only ever posts. It never reads your workspace.

01

One click: Add to Slack

Settings → Integrations → Slack → Add to Slack. Approve in Slack and choose the channel to post into, that single step connects the channel webhook and 1:1 DMs together. No webhook URLs or tokens to copy.
Open Integrations
02

Or: create an Incoming Webhook manually

In Slack, go to Apps → Incoming Webhooks → Add to Slack, pick the channel to post into, and copy the webhook URL (it starts with https://hooks.slack.com/services/…).
03

Paste it into trueno

Settings → Integrations → Slack. Paste the URL, optionally label the channel, and choose which alerts to send (critical findings, cost anomalies). Save, then use Send test to confirm.
Open Integrations
02 · Slack direct messages

DM the assignee directly.

When a finding or recommendation is assigned to someone, trueno DMs that person directly: a personal ping, not just the shared channel. Add to Slack (above) already turns this on; the steps below are only if you'd rather connect your own bot token by hand.

01

Create a Slack app

Go to api.slack.com/apps → Create New App → From scratch, name it (e.g. “trueno”), and select your workspace.
02

Add bot scopes

Under OAuth & Permissions → Bot Token Scopes, add users:read and users:read.email (match the assignee by email; Slack requires both together), chat:write (send the message), and im:write (open the DM).
03

Install + copy the bot token

Click Install to Workspace and authorize. Copy the Bot User OAuth Token. It starts with xoxb-.
04

Connect it in trueno

Settings → Integrations → Slack direct messages. Paste the xoxb- token, enable “DM on assignment,” and use DM me a test. Assignees are matched by their trueno profile email. If someone isn’t in the Slack workspace under that email, their DM is quietly skipped (the channel alert still fires).
Open Integrations
03 · On-call paging

Page on-call for SEV1.

PagerDuty or Opsgenie. Only critical findings page the rotation: a different urgency than Slack or email, so the pager stays meaningful.

01

PagerDuty

In PagerDuty, open the service → Integrations → Add an integration → Events API v2, and copy the Integration/Routing Key.
02

Opsgenie

In Opsgenie, create an API integration (or use Teams → Integrations) and copy its API key.
03

Connect it in trueno

Settings → Integrations → On-call. Pick the provider, paste the key, enable it, and send a test page. Critical findings will open an incident automatically.
Open Integrations
04 · Ticketing

File a finding as a ticket.

GitHub Issues, Jira, or Linear. Once connected, the Ticket button on any finding creates an issue in your tracker with the severity, resource, and remediation prefilled.

01

GitHub Issues

Create a fine-grained or classic PAT with issues: write on the target repo. In trueno pick GitHub, enter the repo as owner/name, and paste the token.
02

Jira

Create an API token at id.atlassian.com → Security → API tokens. In trueno pick Jira and enter your site URL (https://your-site.atlassian.net), the project key (e.g. OPS), the Atlassian account email, and the token. Issues are created as type Task.
03

Linear

Create a personal API key at Linear → Settings → API, and copy the team’s UUID. In trueno pick Linear, paste the team id and the API key.
Open Integrations
05 · Public API & webhooks

Pull data out, get pushed events.

A read-only REST API over your findings, recommendations, resources, and accounts, plus signed outbound webhooks when events fire.

01

Create an API key

Settings → Integrations → API keys → Create key. Copy it immediately; it’s shown once. Call the API with Authorization: Bearer <key>.
02

Call the endpoints

GET /api/v1/findings, /recommendations, /resources, and /accounts, all org-scoped to your key, with ?limit and per-endpoint filters. The full schema is published as OpenAPI 3.1 at /api/v1/openapi.json.
03

Subscribe to webhooks

Add an endpoint under Webhooks and pick events (critical finding, cost anomaly). Each POST is signed: X-Trueno-Signature: sha256=<hmac> over the raw body, keyed by the signing secret shown at creation. Verify it before trusting the payload.
04

Delivery + retries

Every delivery is logged under Recent deliveries. A failed delivery (non-2xx or timeout) is retried automatically with exponential backoff, so a brief outage on your side doesn’t drop the event.
Open Integrations
Support

Stuck connecting something?

Slack, on-call, ticketing, and the API are on Control and Enterprise, and managed by org admins. If a connection won’t verify, the in-app form returns the exact provider error.

Need a hand?

Open support with your workspace id and the integration you’re wiring up. Connection-level questions aren’t gated behind a paid tier.