FAQ / Troubleshooting

Why do I get 401 Unauthorized even though my credentials are valid?

This API uses two separate credential types, and each endpoint accepts only one of them: creating a link and listing domains require a bearer token (Authorization: Bearer <token>); bulk-create, list/search links, get-link-by-id, and click analytics require an API key (X-API-Key). Sending the wrong type for an endpoint returns 401. See Authentication.

Why did my bulk-import request get rejected with 429?

You exceeded your account’s per-second or per-minute rate limit for POST /v1/links/bulk. Check the X-RateLimit-Remaining-Second and X-RateLimit-Remaining-Minute headers on prior responses to see how much headroom you had, and space out your requests. See Limits.

They’re the same operation under two path prefixes — /public/links/bulk is a legacy alias kept for backward compatibility. New integrations should use the /v1/ paths. See API Reference.