Skip to content
Back to Nouncify

Authentication

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

Generate API keys from the Developer Dashboard. Each key has a prefix that indicates its environment:

PrefixEnvironmentPurpose
nfy_live_ProductionReal data, real emails
nfy_dev_DevelopmentTesting (emails suppressed)

Include your API key as a Bearer token:

Terminal window
curl https://api.nouncify.com/v1/collections \
-H "Authorization: Bearer nfy_live_AbCdEfGhIjKlMnOpQrStUvWxYz12"
const response = await fetch('https://api.nouncify.com/v1/collections', {
headers: {
'Authorization': 'Bearer nfy_live_AbCdEfGhIjKlMnOpQrStUvWxYz12',
'Content-Type': 'application/json',
},
});
import requests
response = requests.get(
'https://api.nouncify.com/v1/collections',
headers={'Authorization': 'Bearer nfy_live_AbCdEfGhIjKlMnOpQrStUvWxYz12'}
)
LimitValue
Requests per minute100
Batch invite max recipients100 per request
Play link requests per minute1,000

When rate limited, you’ll receive a 429 Too Many Requests response with a Retry-After header.

In addition to rate limits, your total API usage is capped based on your Nouncify subscription plan:

PlanAPI Requests Allowed
Free1,000
Pro5,000
Business50,000

When your plan’s API quota is exhausted, the API will return a 429 Too Many Requests status code with a QUOTA_EXCEEDED error code in the JSON body:

{
"error": {
"code": "QUOTA_EXCEEDED",
"message": "API quota exceeded (5000 requests allowed for pro tier)",
"status": 429
}
}

To increase your quota, upgrade your plan in the Nouncify Settings dashboard.

  • Store keys in environment variables, not source code
  • Use nfy_dev_ keys for development and testing
  • Rotate keys regularly from the Developer Dashboard
  • Revoke compromised keys immediately