Authentication

Learn how to authenticate your requests to the ImpactAPI using API keys.

API keys

The ImpactAPI uses API keys for authentication. You can generate and manage your API keys from your dashboard.

Authentication method

Include your API key in the Authorization header of your requests:

curl -X POST "https://testing.impactapi.co/donation_intents" \
-H "Authorization: Bearer YOUR_API_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{
  "intents": [
    {
      "amount": 100,
      "campaign_identifier": "trees-for-the-future"
    }
  ]
}'

Authentication errors

If authentication fails, you'll receive one of the following error responses:

{
  "error": {
    "code": "auth.unauthorized",
    "message": "Unauthorized",
    "correlation_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "error": {
    "code": "auth.forbidden",
    "message": "Access forbidden",
    "correlation_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}