Authentication

Learn how to authenticate your requests to the DJfindr API.

The DJfindr API uses API keys (credentials) to authenticate and authorize requests. You can manage your API credentials in the Integrations section of your account settings.

Method

Authentication with the DJfindr API is performed using HTTP Bearer Authentication (also known as token authentication). Include your API key as a Bearer token in the Authorization header of each request.

Authentication Request

Authorization: Bearer YOUR_API_KEY

Security Requirements

• HTTPS Only: All API requests must be made over HTTPS. Requests made over plain HTTP will be rejected for security reasons.
• Authentication Required: API requests without a valid API key will fail with an authentication error. Always include your key in the Authorization header to ensure successful communication with the API.

---

Creating a credential

Navigate to Dashboard > Account > Integrations then scroll to API Access to manage your API credentials.

Create a new credential using the Create Token button, adding a label to describe the use of the token (for example: CRM Software, SoundCloud, etc.) along with your password for security.

If you don’t see the API Access option or it prompts to upgrade, then API access is not included in your current plan and upgrading is required to continue.

After clicking Create, you will be provided with your Bearer token. Copy this token or note it down in a safe place — this token cannot be retrieved after closing the dialog.

Your API keys provide access to sensitive operations and data. Keep them secure by following these guidelines:

• Do not expose your secret API keys in public areas like GitHub, client-side code, or shared repositories.
• Treat your API keys as sensitive credentials to protect your account and data.

---

Testing a credential

Use the GET /wf/auth_check endpoint to verify your API key is working correctly.

curl --request GET \
  --url https://djfindr.com/api/1.1/wf/auth_check \
  --header "Authorization: Bearer YOUR_API_KEY"

Responses

Code	Meaning
200	Success — your credential is valid
401	Permission denied — key is missing or invalid
429	Too many requests — slow down and retry
500	Internal error — file a bug report
503	Service unavailable

All set! You’re ready to create API integrations with DJfindr.