Grassrootz API

Name: Grassrootz API
Brand: Grassrootz API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentPaymentsBilling SubscriptionsapiKey7 EndpointsREST

For Agents

Look up Grassrootz fundraising accounts, campaigns, donations, and events, and register webhooks for change notifications.

Install Jentic One Beta

Connect the Grassrootz API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Grassrootz API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Grassrootz API.

Retrieve the authenticated organization's account record from /v1/account

List and inspect fundraising campaigns from /v1/campaigns

Pull donations associated with the organization from /v1/donations

GET STARTED

Start building with Grassrootz API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Grassrootz API for, with concrete tasks.

★ Donation Reconciliation into Finance Systems

Charities running Grassrootz campaigns reconcile donation activity into accounting tools by polling /v1/donations on a schedule, matching against bank deposits, and posting journal entries downstream. The dual-key model keeps the read-only flow auditable from the finance team's service account.

Fetch all donations from /v1/donations created in the last 24 hours and write each one as a journal entry in the accounting system

Campaign Performance Dashboards

Fundraising teams build internal dashboards that pair /v1/campaigns with /v1/donations to show running totals, donor counts, and conversion against goals. Refreshing on a five-minute cadence keeps the dashboard close to live without exhausting tenant rate limits.

List all campaigns and for each one sum the amount field across associated donations to build a 'percent of goal' metric

Event-Triggered Donor Communications

Marketing automation flows subscribe to webhooks via /v1/webhooks so that a thank-you message, tax receipt, or social post is triggered when a donation completes or a fitness event milestone is reached, without polling the API.

POST a webhook subscription to /v1/webhooks pointing to the team's automation endpoint and verify the subscription returns a 201

Agent-Driven Fundraising Assistant via Jentic

An AI fundraising assistant uses Jentic to discover the right Grassrootz operation when a charity worker asks 'what came in last night?' or 'is the bike ride campaign live?'. Jentic injects ClientKey and ClientSecret from the vault so the agent never holds either credential.

Search Jentic for 'list grassrootz donations', load the schema, and execute /v1/donations to summarize the last 24 hours

Key Endpoints

7 endpoints — jentic publishes the only available openapi specification for grassrootz api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/v1/account

Retrieve the authenticated organization's account

GET

/v1/campaigns

List fundraising campaigns

GET

/v1/donations

List donations

GET

/v1/events

List configured events

POST

/v1/webhooks

Subscribe to webhook notifications

GET

/v1/account

Retrieve the authenticated organization's account

GET

/v1/campaigns

List fundraising campaigns

GET

/v1/donations

List donations

GET

/v1/events

List configured events

POST

/v1/webhooks

Subscribe to webhook notifications

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Grassrootz ClientKey and ClientSecret are stored encrypted in the Jentic vault and injected as request headers at execution time. The agent never sees either secret in its prompt or response.

Intent-based discovery

Agents search Jentic by intent (e.g., 'list donations from grassrootz') and Jentic returns the matching operation along with its parameter schema, so the agent calls /v1/donations or /v1/campaigns without browsing the developer portal.

Time to first call

Direct Grassrootz integration: half a day to wire dual-key headers, pagination, and webhook handshake. Through Jentic: under 30 minutes — search, load schema, execute.

FAQs

Specific to using Grassrootz API through Jentic.

Why is there no official OpenAPI spec for Grassrootz API?

Grassrootz does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Grassrootz API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Grassrootz API use?

The API uses a dual-key model. ClientKey is required as a header on every request to public endpoints, and ClientSecret is added as an additional header for private or authenticated endpoints. Both keys are issued by the Grassrootz support team. Through Jentic both headers are stored in the encrypted vault and injected per call.

Can I retrieve historical donations through this API?

Yes. GET /v1/donations returns the donations visible to the authenticated organization. Filter and pagination behaviour is documented in the Grassrootz developer portal at https://grassrootz.readme.io/reference/getting-started-with-your-api, and webhooks via /v1/webhooks are recommended for near-real-time updates rather than tight polling.

What are the rate limits for the Grassrootz API?

Grassrootz does not publish a public rate-limit table. The administrator portal access scope means access keys carry the same permissions as an Organization Administrator, so excessive polling can affect tenant performance. Use webhooks via /v1/webhooks for change-driven flows and apply a conservative poll cadence on /v1/donations and /v1/campaigns.

How do I list current campaigns through Jentic?

Search Jentic for 'list grassrootz campaigns', load the operation that maps to GET /v1/campaigns, and execute it. The response includes campaign identifiers, names, and goal amounts which can then be paired with /v1/donations to compute progress.

Does the API support write operations like creating a donation?

The published spec covers reads on accounts, campaigns, donations, and events, and webhook subscription via /v1/webhooks. Direct donation creation typically happens through the Grassrootz hosted donation pages rather than this API. Confirm with Grassrootz support whether your tenant has additional write scopes enabled.