Authentication

Authentication is a crucial step in utilizing HeyAutos Outbound Syndication API. To access our syndicated inventory data, you must provide a valid API key via an Authorization Header in your API requests.

Obtaining your API key

To obtain your unique API key, please contact HeyAutos technical support team at it@heyauto.com. Our team will provide you with the necessary credentials to get started.

Including the API key in your requests

Once you have your API key, you must include it in the Authorization header of your API requests. Here's how to structure the header:

Authorization: Bearer <YOUR_API_KEY>

Replace <YOUR_API_KEY> with the actual API key provided to you.

Authorization

Authorization within HeyAutos Outbound Syndication API is essential for security and control. Each partner is granted access to specific, approved dealerships' inventory. Attempting to access the inventory of a dealership that has not been approved will result in a failed request. This ensures that only authorized partners can retrieve and integrate HeyAutos syndicated inventory data, maintaining the integrity and privacy of dealership information. If you require access to additional dealerships or have any questions related to authorization, please contact HeyAutos technical support team at it@heyauto.com for assistance.

Forbidden requests

In the HeyAuto Outbound Syndication API, requests can be forbidden, resulting in an HTTP status code 403, due to authentication or authorization failures. Authentication may fail if the API key is invalid or missing in the Authorization Header, while authorization failures occur when attempting to access non-approved dealership data.

Security

Protect your API key as you would any sensitive credential. Keep it confidential to prevent unauthorized access to your syndicated inventory. If you suspect that your API key has been compromised, please contact HeyAutos technical support team immediately.