Heymarket offers a full featured API used by many companies to build integrated workflows. Full API reference and guides are available at developers.heymarket.com.
Heymarket also supports Webhooks for actions like Message Sent and Chat Assignment.
Authentication methods
Every API request must be authenticated. Heymarket supports two methods:
- API Secret (recommended). Create an API Secret to get a Secret ID and Secret Key. Your backend uses those values to generate short-lived JWT Bearer tokens for API requests.
- API key (legacy, planned for deprecation). A static team API key passed as a Bearer token.
Note:
Access via the legacy API key is planned for deprecation. New integrations should use API Secret authentication. Existing integrations using API keys should plan to migrate.
Where to find credentials
In Heymarket, go to Settings → Integrations → API to create API Secrets or view existing API credentials. (app.heymarket.com/admin/integrations/api).
Notes:
The Secret Key is only shown once at the time it is generated. Copy and store it immediately. The app masks existing secrets afterward.
JWTs must be generated from a trusted backend or server-side job. Never generate them from browser, mobile, or other client-side code.
Need help with Heymarket API?
For step-by-step API Secret setup, JWT generation examples, and request authentication details, see the API authentication guide. For endpoint documentation, see the Heymarket API reference. For additional questions on Webhooks or the API, please contact Heymarket support.
We are excited to see what you build!