Integrations
Read your Grondeo activity through the API.
Retrieve the activity feed or connect a named agent to account history through separate REST endpoints on Starter or Pro.
Connected activity
3 events from 3 sourcesGitHub · Linear · Stripe
- GitHubPull request mergedMerged
Event from this source
- LinearIssue updatedUpdated
Event from this source
- StripePayment receivedRecorded
Event from this source
Connected source
3 sources connectedRead collected activity
What you can do with this connection
An internal workflow may need access to the activity already collected in Grondeo.
Example events
- Pull request merged
- Issue updated
- Payment received
How to use it
On Starter or Pro, use the activity API to retrieve the feed. For agent workflows, create a named agent key with separate scopes and use the Agent REST API to search activity, record actions, and update follow-ups. Custom JSON ingestion and incoming webhooks are a separate Pro feature.
Important limitation
The activity feed API retrieves events. Named agents use separate REST routes and scopes to record actions and update follow-ups. Pro custom integrations handle importing from your own JSON endpoints.
Connection guide
What you need to get started
Choose an API path on Starter or Pro
- Create your account and connect a source.
- For the activity feed, create a key and retrieve recorded events. Configure outgoing webhooks if your system should receive updates.
- For agent workflows, create a named agent in Settings, choose its permissions, and use the Agent REST API or MCP server.
Named agents can record actions and update follow-ups. See agent access. To ingest events from your own JSON endpoint or incoming webhook, use a Pro custom integration.
Plan and history
Activity API access and outgoing activity webhooks require Starter or Pro.
Your plan sets the searchable history window: 7 days on Free, 60 on Starter, and 365 on Pro. Source APIs, permissions, and connection methods determine which events can be collected. A longer history window does not guarantee a complete backfill; webhooks collect events delivered after setup.
Compare plansIn the timeline
Inspect individual updates
On Starter or Pro, use the activity API to retrieve the feed. For agent workflows, create a named agent key with separate scopes and use the Agent REST API to search activity, record actions, and update follow-ups. Custom JSON ingestion and incoming webhooks are a separate Pro feature.
- 10m agoGitHub
Pull request merged
- 2h agoLinear
Issue updated
- 4h agoStripe
Payment received
Best used for
Activity feed
Agent REST API
Outgoing webhooks
MCP alternative
Questions
Before you get started
Which plan do I need?
The activity API, named agent access, and outgoing activity webhooks require Starter or Pro. Custom JSON sources and incoming webhooks require Pro.
How is the Agent REST API different?
The Agent REST API uses a named agent key with separate permissions for activity reading, action recording, follow-up reading, and follow-up updates. It can write agent actions and follow-up changes into account history.
Get started