Food relief
Thousands of donors already trust us, and we work hard to keep it that way. Clear prices, honest advice and no surprises along the way.
Overview
You receive photos and updates showing exactly what your donation achieved. Ninety cents of every dollar goes directly to the projects you support. Clean water wells are built with and maintained by local communities.
Installation
Install the SDK with the package manager your project already uses. It needs Node 18 or newer.
$ npm install @glowia/sdk$ yarn add @glowia/sdk$ pnpm add @glowia/sdkConfiguration
Our team has done this many times, so you never have to guess. We listen first, then build a plan around what you actually need. Create a file named glowia.config.json in the project root:
{
"project": "glowia",
"region": "ap-south",
"categories": ["education", "health", "environment"],
"retries": 4,
"timeoutMs": 10000,
"webhooks": { "enabled": true }
}| Option | Type | Default | Description |
|---|---|---|---|
project | string | - | Your project key from the dashboard. |
region | string | "us-east" | Data centre closest to your donors. |
retries | number | 3 | How often a failed call is retried. |
timeoutMs | number | 10000 | Time before a request is cancelled. |
webhooks.enabled | boolean | false | Send events to your endpoint. |
Your first request
Monthly gifts let us plan ahead and respond quickly when disaster strikes.
- Create an API keyOpen the dashboard, choose Settings › API keys and copy a new secret key.
- Store it safelyKeep the key in an environment variable, never in your source code.
- Make the callRun the snippet below; it prints the first page of results.
import { Client } from "@glowia/sdk";
const client = new Client({ apiKey: process.env.API_KEY });
// list the newest campaigns in one category
const page = await client.campaigns.list({ category: "education", limit: 20 });
for (const item of page.data) {
console.log(item.name, item.price);
}API reference
Every endpoint returns JSON and uses standard HTTP status codes.
/v1/campaignsList campaigns with paging and filters./v1/campaignsCreate a new campaign./v1/campaigns/{id}Update some fields of a campaign./v1/campaigns/{id}Archive a campaign; it can be restored for 30 days.{
"data": [
{ "id": "campaign_5892", "name": "Tree planting", "price": 258 }
],
"has_more": true
}Troubleshooting
Next steps
Local partners know their communities and make sure help arrives where it matters.