GiveLinkDocs
API Reference

Authentication

How to authenticate with the GiveLink API.

All API requests must include your API key in the Authorization header.

API Keys

Generate API keys from your organization dashboard: Settings > API Keys.

There are two types of keys:

Key TypePrefixUse Case
Livegv_live_Production — processes real donations
Testgv_test_Development — uses Stripe test mode, no real charges

Usage

Include the key as a Bearer token:

curl -X GET https://api.givelink.ai/api/campaigns \
  -H "Authorization: Bearer gv_test_abc123..."

Security Best Practices

Never expose API keys in client-side code. API keys should only be used in server-to-server requests. For client-side donation forms, use the publishable key and Stripe Elements instead.

  • Store keys in environment variables, never in source code
  • Use test keys (gv_test_) during development
  • Rotate keys immediately if compromised
  • Use the minimum required scope for each integration
How is this guide?

On this page