Docs · Integrations

Connect yourexisting 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.