Powerful RESTful API for building custom integrations and applications on top of your church data.
Get up and running with the GraceBase API in minutes.
Use API keys for secure, straightforward authentication. Generate keys from your account settings.
Intuitive REST API with JSON responses. Uses standard HTTP methods and status codes.
1,000 requests per hour for standard plans. Contact us for higher limits.
Detailed documentation with code examples in multiple languages.
// 1. Install the SDK
npm install @gracebase/api
// 2. Initialize with your API key
import GraceBase from '@gracebase/api';
const gracebase = new GraceBase({
apiKey: process.env.GRACEBASE_API_KEY
});
// 3. Make your first request
const members = await gracebase.members.list({
limit: 10,
active: true
});
console.log(members);All API requests require an API key passed in the Authorization header. You can generate API keys from your account settings in the GraceBase dashboard.
Base URL
https://api.gracebase.co/v1// Authentication using API key
const response = await fetch('https://api.gracebase.co/v1/members', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
});
const data = await response.json();Core endpoints for managing your church data programmatically.
/v1/membersList all members with pagination and filters
/v1/membersCreate a new member record
/v1/members/:idGet a specific member by ID
/v1/members/:idUpdate member information
/v1/donationsList all donations with date range and filters
/v1/donationsRecord a new donation
/v1/donations/:idGet donation details
/v1/eventsList upcoming and past events
/v1/eventsCreate a new event
/v1/events/:idUpdate event details
Creating resources is simple and follows standard REST conventions. Send a POST request with JSON data to create new members, donations, events, and more.
// Create a new member
const newMember = await gracebase.members.create({
firstName: 'John',
lastName: 'Smith',
email: 'john@email.com',
phone: '555-123-4567',
status: 'active'
});The GraceBase API opens up endless possibilities for customization.
Build a native mobile app for your congregation with member directory access and event RSVP.
Trigger actions in external systems when donations are received or new members join.
Pull data into your own analytics platform or create custom dashboards.
Connect GraceBase with tools we don't natively integrate with using Zapier or Make.
Upgrade to a Pro plan to get full API access and start building custom integrations today.