Granicus API
Granicus is the citizen experience platform for government, powering communications, meeting and agenda management, digital services, permitting and licensing, and public records for local, state, and federal agencies. An unofficial API lets you programmatically pull subscribers, topics, bulletins, meetings, agenda items, permits, and records requests—and push updates like new subscriptions, message sends, and service requests back into Granicus.
What is Granicus?
Granicus is the citizen experience platform for government, providing cloud software that helps local, state, and federal agencies deliver digital services, engage their communities, and automate operations. Government organizations use Granicus to run subscriber communications and outbound messaging, manage public meetings and agendas, publish websites and digital forms, process permits and licenses, and handle public records requests—all from a connected Government Experience Cloud.
Core product areas include:
- Government Experience Cloud (Service Cloud, Engagement Cloud, Operations Cloud)
- Communications Cloud / GovDelivery (subscriber communications, bulletins, email and SMS)
- Targeted Messaging (TMS) and Interactive Text (2-way SMS citizen engagement)
- Agenda and meeting management, websites/CMS, and digital forms
- Permitting/licensing and public records request management
- Government Experience Agent (GXA) AI self-service and GXI analytics/insights
Common data entities:
- Subscribers, Subscriptions, Topics, Categories
- Bulletins, Email Messages, SMS Messages, Voice Messages
- Meetings, Agendas, Agenda Items, Minutes, Recordings
- Permits, Licenses, Applications, Inspections
- Public Records Requests, Forms, Submissions, Service Requests
- Delivery, Open, Click, and Engagement Reports
The Granicus Integration Challenge
Agencies run mission-critical citizen services on Granicus daily, but turning portal- and product-specific workflows into unified API-driven automation is non-trivial:
- Fragmented product surface: Communications Cloud, TMS, Interactive Text, agenda management, forms, and records each have their own object models, IDs, and auth
- Multiple API generations: Communications Cloud, the legacy GovDelivery REST API, and Reports PRO differ in coverage, versioning, and payload shape
- Account-scoped credentials: API access is gated by account, with per-account tokens and entitlements that vary by the products an agency has licensed
- Portal-only data: Meeting recordings, agenda packets, and many operations workflows live behind the admin UI rather than a documented endpoint
- Mixed formats: Some surfaces speak XML while others return JSON, requiring careful parsing and normalization
- Compliance and audit needs: Public records, accessibility, and retention requirements demand precise, traceable handling of every request and response
- Rate and deliverability sensitivity: Bulk messaging and SMS sends must respect throttles and deliverability rules to avoid disrupting citizen communications
How Supergood Creates Granicus APIs
Supergood reverse-engineers authenticated browser flows, the Communications Cloud and TMS REST APIs, and admin-only workflows to deliver a resilient, unified API layer for your Granicus account—across communications, meetings, forms, and records.
- Handles account credentials, API tokens, and MFA securely in a managed session
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across Communications Cloud, TMS, agenda management, forms, and records into consistent JSON objects
- Aligns with your account's licensed products and entitlements to ensure compliant access
Use Granicus with AI agents: Granicus MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your Granicus products, accounts, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready Granicus adapter tailored to your account configuration and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Granicus evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a Granicus account using API credentials or username/password and obtain a session token for downstream calls.
Communications
/subscribersList subscribers across topics and categories with filters for status, signup date, and engagement.
Communications
/create_subscriptionAdd a subscriber to one or more topics or categories within Communications Cloud.
Communications
/send_bulletinCompose and send an email or SMS bulletin to a topic, category, or targeted audience via TMS.
Meetings
/meetingsRetrieve meetings, agendas, agenda items, and minutes with filters for body, date, and status.
Records
/records_requestsPull public records requests, forms, and service request submissions with status and assignment filters.
Use Cases
Sync subscriber and engagement data into your stack
- Pull subscribers, topics, and subscription status from Communications Cloud into a CRM or data warehouse - Stream open, click, and delivery reports to BI and analytics tools - Reconcile subscriber records across topics for a unified citizen view
Automate outbound government communications
- Trigger email and SMS bulletins through TMS from external events and case systems - Manage 2-way Interactive Text conversations programmatically for real-time citizen engagement - Apply throttles and deliverability rules automatically to protect critical sends
Publish and track meetings and agendas
- Pull meetings, agendas, agenda items, and minutes into public-facing portals and calendars - Sync recordings and packet metadata to downstream archives and transparency sites - Notify subscribers automatically when a new agenda or meeting is published
Streamline permits, forms, and records requests
- Sync permit, license, and form submissions into case management and ERP systems - Route public records requests and service requests to the right department without portal clicks - Push status updates back to citizens and internal dashboards
Technical Specifications
Authentication
Account API tokens, username/password, and MFA handled in a managed session
Connectivity
Authenticated browser flows plus the Communications Cloud, TMS, and Interactive Text REST APIs where exposed by the account
Response format
Normalized JSON across communications, meetings, forms, and records objects, including sources that natively return XML
Rate limits
Adaptive throttling tuned to your account to respect Granicus send and API limits
Session management
Automatic session refresh, token rotation, and MFA replay handling
Data freshness
Near real-time pulls for subscribers, messages, and requests with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for new subscriptions, message delivery, agenda publication, and records request status
Latency
Sub-second reads on cached entities; multi-second writes when posting bulletins and form submissions
Throughput
Horizontally scaled workers sized to high-volume subscriber and bulk-messaging workloads
Reliability
Retry, backoff, and idempotency keys for message sends and submission writes
Adaptation
Continuous monitoring of Granicus product releases and account-specific configuration drift
Frequently asked questions
Yes. Supergood normalizes data across the Communications Cloud API, the legacy GovDelivery REST API, and TMS, so subscribers, topics, bulletins, and reports are exposed through one consistent surface regardless of which generation your account uses.
Yes. Bulletins, targeted email, and SMS sends through TMS and Interactive Text are available through the API, with adaptive throttling so high-volume sends respect Granicus deliverability and rate rules.
No. Supergood works with your existing Granicus account credentials, API tokens, and entitlements. You only need access to the products your agency has already licensed.
Yes. For workflows without a documented endpoint, Supergood reverse-engineers the authenticated admin flows so meetings, agenda packets, recordings, and records requests are available alongside API-exposed data.
Each account is profiled against the Granicus products it has licensed. Supergood preserves account-specific topics, forms, and entitlements rather than forcing a generic schema.