hey molly
API Docs

Hey Molly API

Integrate Molly's brand-voice engine and content generation into your own tools. RESTful endpoints, Bearer-token auth, and JSON responses.

Authentication

All API requests require a Bearer token in the Authorization header. Obtain your key from the Settings → API page inside your Hey Molly dashboard. Keep it secret and rotate it regularly.

Authorization: Bearer <YOUR_API_KEY>

Base URL

https://api.heymolly.io/v1

Core endpoints

POST
/v1/brand-voice/analyze

Upload sample text, social posts, or web copy and receive a structured brand-voice profile. Returns tone dimensions, vocabulary fingerprint, and sentence-style metrics you can store and reuse.

POST
/v1/content/generate

Generate blog posts, emails, ad copy, or social captions in your saved brand voice. Accepts a content brief (topic, length, format) and returns draft text with optional variant alternatives.

POST
/v1/chat/completions

Conversational interface to Molly. Send a sequence of messages and receive a context-aware reply that respects your brand voice settings. Ideal for chatbots and in-app assistants.

POST
/v1/repurpose

Transform a single piece of content into multiple formats automatically. Turn a blog post into tweet threads, LinkedIn updates, or email summaries while preserving tone and key points.

Rate limits & support

Standard plans include 1,000 requests per minute. Enterprise customers receive dedicated throughput and priority support. For questions, integrations, or custom endpoints, reach out to hello@heymolly.io.