Authentication

The Givebutter API uses Bearer token authentication to secure all API requests. All requests must be made over HTTPS.

Quick Start

Include your API key in the Authorization header of every request:

curl https://api.givebutter.com/v1/campaigns \
  -H "Authorization: Bearer YOUR_API_KEY"

Go to Settings → Integrations → API Keys in your Givebutter Dashboard
Click Create New API Key and give it a name
Copy your API key immediately and store it securely

Your API key is shown only once. Never share it or commit it to version control.

Your API key is missing, invalid, or revoked.

{
  "message": "Unauthenticated."
}

Common causes:

API key is missing from the request
API key is incorrect or has typos
API key has been revoked
Using Authorization: YOUR_API_KEY instead of Authorization: Bearer YOUR_API_KEY

Your API key is valid but lacks permission for this resource.

{
  "message": "This action is unauthorized."
}

Common causes:

⌘I