Sources · Coordinate docs

Everything that can feed your event log, how each connects, and the events it records.

Connect sources on Connections, or with configure ({"sources": [...]}) or connect_source over the API. Polled sources import recent history quietly when connected, then check on a schedule; Check now (poll_source) checks immediately.

GitHub

One click creates a private GitHub App for your deployment; install it on the repositories to watch. Pull requests, reviews, check runs, statuses, pushes, commits, and GitHub Actions workflow runs arrive by webhook. The GitHub connector also runs a readiness poller: for each open pull request it asks GitHub whether the PR is open, not a draft, mergeable, approved (or needs no review), and green, and records github.pr.readiness when that changes. Webhooks nudge it, so readiness follows within seconds.

The last 90 days are imported when repositories are added: pull requests, reviews, check results, completed Actions runs, and commits on the default branch. In a fork, only commits by the account the app is installed on are imported, and a push that syncs the fork records only the pusher's own commits, so upstream history doesn't read as yours. Commits on other branches arrive only live. If commits or runs are missing (a webhook GitHub never delivered), re-import the repository with coordinate configure '{"backfill": {"repo": "owner/name"}}': commits and runs already recorded are skipped. Imported Actions runs need the app's Actions: Read-only permission; coordinate status says when a permission is missing.

Notion

Click Connect, pick the pages and teamspaces Coordinate may read on Notion's consent screen, and you're done. (On a deployment without a Notion OAuth app, create an internal integration at notion.so/profile/integrations, paste its secret, and share pages with it instead.) Pages and database rows are recorded as they are created, edited, and archived.

Cloudflare

Create an API token (not the Global API Key) with read access to Account Settings, Workers Scripts, and Cloudflare Pages. For an account-owned token, add the account ID. Records the account audit log, Worker deploys, and Pages deployment stages.

Vercel

Paste an access token (add the team ID for a team). A built-in poller records every deployment as it queues, builds, goes live, fails, or is canceled.

Granola

Paste a grn_ API key (Business or Enterprise plan). Each meeting's notes arrive when the AI summary is ready.

Gmail

Click Connect and approve read-only access to message headers and labels in Google. Coordinate never reads message bodies. Mail from then on becomes gmail.message.received (inbox) and gmail.message.sent events with the sender, recipients, subject, snippet, labels, and thread; each thread is a subject (gmail:thread:<id>), as is each sender (email:<address>). Gmail notifies Coordinate through Google Cloud Pub/Sub within seconds of new mail, and Coordinate also checks every 10 minutes. Disconnecting revokes the grant at Google.

PostHog

Click Connect, sign in to PostHog (US or EU cloud), and pick the project to connect. Coordinate adds an HTTP webhook destination named "Coordinate" to that project, and every event PostHog captures from then on arrives in the log within seconds: $pageview as posthog.pageview, Signed Up as posthog.signed_up. The payload has the original event name, distinct_id, properties, the person (id and name), and a link to the event in PostHog; each person is a subject (posthog:person:<distinct_id>). Coordinate checks the destination every few hours and restores it if it was paused or edited. Disconnecting deletes the destination and revokes the grant. PostHog includes 10,000 destination deliveries a month for free and charges per delivery after that, so a busy project costs money on the PostHog side.

Linear

Click Connect and approve read access in Linear, or paste a personal API key (Settings → Account → Security & access). The last 30 days are imported as history. Afterwards, a one-click connection is updated within seconds: Linear notifies Coordinate of each change, and Coordinate also checks every 15 minutes in case a notification is missed. A pasted key is checked every 2 minutes. Coordinate records issues created, updated, completed, canceled, and archived (linear.issue.*) and new comments (linear.comment.created). Issue events carry the identifier, title, the first 2,000 characters of the description, state, team, project, cycle, assignee, priority, labels, and due date. Each issue is a subject (linear:issue:<id>), as are its team, project, and assignee. Disconnecting a one-click connection revokes the grant at Linear.

Todoist

Click Connect and approve read access in Todoist. Existing tasks are a silent baseline; afterwards tasks added, completed, edited, and deleted, and reminders, become events.

Web pages and feeds

Give any public https URL and a name. A built-in poller records one event per new entry of an RSS or Atom feed, or an event with the added lines when a page's text changes. Checked hourly by default.

Claude Code

Connect to get a settings.json block that points Claude Code's OpenTelemetry logs at https://usecoordinate.com/otlp. Each API call becomes one claude_code.usage event with cost and tokens.

An agent can set it up too. Create the source with coordinate configure '{"sources": [{"kind": "http", "name": "claude-code", "description": "Claude Code telemetry"}]}', which returns an ingest token (or, if the source already exists, run coordinate token claude-code for a new one). Then merge this into ~/.claude/settings.json and restart Claude Code:

json

{"env": {"CLAUDE_CODE_ENABLE_TELEMETRY": "1", "OTEL_LOGS_EXPORTER": "otlp", "OTEL_METRICS_EXPORTER": "none",
  "OTEL_EXPORTER_OTLP_PROTOCOL": "http/json", "OTEL_EXPORTER_OTLP_ENDPOINT": "https://usecoordinate.com/otlp",
  "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer <ingest token>"}}

Connections recognizes that source and won't create a second one.

Claude Managed Agents

Add https://usecoordinate.com/hooks/anthropic/<workspace>/<name> as a webhook endpoint in the Claude Console and paste its whsec_ signing secret. Session, agent, deployment, and vault changes arrive as anthropic.* events.

Your apps (HTTP)

Create an HTTP source on Connections, or with coordinate configure '{"sources": [{"kind": "http", "name": "deploys"}]}', to get an ingest token that can only append to it. It's shown once; coordinate token deploys (the create_ingest_token operation) makes another.

bash

curl -X POST https://usecoordinate.com/v1/sources/deploys/events \
  -H "Authorization: Bearer $INGEST_TOKEN" -H "content-type: application/json" \
  -d '[{"type": "deploy.finished", "producer_event_id": "deploy-481", "payload": {"service": "api", "status": "ok"}}]'

Any OpenTelemetry logs exporter can also post OTLP/HTTP JSON to https://usecoordinate.com/otlp/v1/logs with an ingest token.

Event types