Skip to main content
Heymarket is a business messaging platform for SMS, MMS, and email conversations. The Heymarket API gives you programmatic access to customer-facing messaging workflows, including sending messages, managing contacts, organizing lists, and tracking conversations. Use the API when you need to connect Heymarket to a CRM, ecommerce system, internal tool, data pipeline, or custom customer workflow.

​
What you can do

With the Heymarket API you can:
  • Send messages - send SMS, MMS, and email messages to individual contacts or lists
  • Manage contacts - create, update, search, delete, and enrich contact records
  • Track conversations - open, close, reassign, and transfer customer conversations
  • Organize lists - build and manage contact lists for broadcast messaging
  • Use templates - create and send saved message templates
  • Schedule messages - queue messages to send at a specific time
  • Receive webhooks - subscribe to real-time events for inbound messages and status changes

​
Base URL

Send all API requests to: 
https://api.heymarket.com

​
JSON encoding

Request bodies must be JSON-encoded. Most object responses are JSON; some endpoints and errors return plain text or string values as shown in the API reference. Set Content-Type: application/json on every request that includes a body. 
Content-Type: application/json

​
HTTPS requirement

The Heymarket API accepts requests over HTTPS. Requests made over plain HTTP or without authentication fail.

​
Authentication

Every endpoint in the OpenAPI reference requires authentication. API Secret JWT authentication is recommended for new integrations. See Authentication for all supported methods.

​
Next steps

Authentication

Create an API Secret and learn how to authenticate every request.

Rate limits

Understand rate limits, request IDs, and how to handle errors.

Send a message

Follow a step-by-step guide to send your first SMS or MMS.

API reference

Browse the full reference for all available endpoints.