GET STARTED

Quickstart

Create an API key in your dashboard, set it as EMOTE_API_KEY on your server, and make your first request below.

You get 1,000 free requests with no credit card required.

POST /v1/react

const response = await fetch("https://useemote.com/v1/react", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.EMOTE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "message": "I finally got the job!",
    "agent": "A thoughtful friend. Warm, genuine, and never over the top.",
    "reactions": [
      "❤️",
      "🎉",
      "👍"
    ]
  }),
});

if (!response.ok) throw new Error(`Emote: ${response.status}`);
const reaction = await response.json(); // an emoji, custom ID, or "none"

The API base URL is https://useemote.com.

A successful response is a JSON string such as "🎉" or "none". To connect this to your message handler, see the example or a platform guide.