API Keys
Get API keys
Use this endpoint to retrieve a list of the active API keys for your Company. Use this when building a key-management view, auditing existing keys, or checking which keys belong to which Accounts.
Filtering options
accountIdsquery parameter - array of Account IDs to scope the list to keys with access to those AccountsRequest-Sourceheader - source of the request (api_native,api_zapier,api_salesforce,api_ftp,api_make)
Please note
- The actual API key secret (
apiKeyfield value) is never returned by this endpoint. The secret is shown only once - in the response toPOST /v2/authentication/apiKeys- and is not retrievable afterward. This endpoint returns metadata only.
Permissions
- Requires:
apiKeys:read
GET
Get API keys
Authorizations
Company Level Authentication
Company level authentication provides access to all resources under your company, including accounts, campaigns, gifts, and recipients.
Getting Your API Key
- Create an API Key: Use the
POST /v2/authentication/apiKeysendpoint to generate a new API key - Set Expiration: Choose from 30, 60, 90, or 180 days (default: 90 days)
- Optional mTLS: Enable mutual TLS for enhanced security
- Name Your Key: Provide a descriptive name for easy identification
Using Your API Key
Include your API key in the X-Api-Key header for every request:
API Key Management
- Maximum Keys: Up to 3 active API keys per company
- Rotation: Delete old keys before creating new ones when at the limit
- Security: Keys are hashed and cannot be retrieved after creation
Enhanced Security (mTLS)
For production environments, enable mutual TLS authentication:
- Set
enforceMtls: truewhen creating the API key - Contact support to obtain your client certificates
- Use the mTLS endpoint:
https://mtls-api.snappy.com/public-api
Headers
Source of the request
Available options:
api_native, api_zapier, api_salesforce, api_ftp, api_make Example:
"api_native"
Query Parameters
Response
Ok
Response containing API keys.
The API keys of the company.
Last modified on June 17, 2026