Skip to main content
The Heymarket API lets you build customer messaging workflows on top of the same inboxes, contacts, conversations, lists, and templates your team uses in Heymarket.

Read the overview

Learn how the API is organized and what you can build with it.

Authentication

Create an API Secret and generate signed JWTs.

Send a message

Follow the first-message guide after you have an inbox ID and sender ID.

API reference

Browse endpoint details for contacts, messages, conversations, and more.

​
Quick start

You need a Heymarket account and an API Secret before making API calls.
1

Create an API Secret

Log in to Heymarket and go to Settings > Integrations > API to generate an API Secret.
2

Generate a signed JWT

Follow the authentication guide to generate a short-lived JWT from your API Secret ID and Secret Key.
3

Authenticate requests

Pass your signed JWT as a Bearer token in every request:
Authorization: Bearer YOUR_SIGNED_JWT
4

Confirm access

Call GET /v1/inboxes to verify authentication and find the inbox IDs available to your team.
curl https://api.heymarket.com/v1/inboxes \
  -H "Authorization: Bearer YOUR_SIGNED_JWT"
5

Send a message

Use an inbox ID and sender member ID from your account when sending a message.
curl -X POST https://api.heymarket.com/v1/message/send \
  -H "Authorization: Bearer YOUR_SIGNED_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "inbox_id": 42,
    "creator_id": 7,
    "phone_number": "14155551234",
    "text": "Hello from the Heymarket API!"
  }'
6

Keep building

Browse the API Reference to discover contacts, conversations, lists, templates, and more.

Sign in

Open Heymarket to get credentials, inbox IDs, and team member IDs.

Book a demo

Talk with Heymarket about your messaging use case.

Visit the website

Learn more about Heymarket products, integrations, and pricing.

Contact sales

Ask about plans, availability, and account setup.