Get started
Overview
What the CueDM API and webhooks do, what they cost, and a first request in five minutes.
What you can build
CueDM answers Instagram comments, story replies and DMs for you. The developer tools let you take what happens there somewhere else, as it happens:
- add every email a DM collects to your email list or CRM;
- log each DM sent and each link clicked in a spreadsheet or your warehouse;
- post to Slack when a DM fails, so someone can reply by hand;
- connect CueDM to Zapier or Make with a key instead of pasting URLs;
- let Claude, ChatGPT or Cursor set up automations and report how they're doing, by connecting an AI agent.
Three ways to connect
Pick by who is connecting. Most no-code integrations only need webhooks.
AI agents
Claude, ChatGPT, Cursor and other AI apps connect to CueDM's MCP server and sign in with your account. No key to paste.
Webhooks
CueDM sends a signed POST to your URL when an event happens. Available on every plan.
REST API
Your code calls CueDM with a workspace API key: accounts, posts, automations and their results, the knowledge base and webhooks. Part of the Studio plan.
You can subscribe to these events: dm.sent (dm sent), dm.failed (dm failed), link.clicked (link clicked), contact.created (new contact), contact.email_captured (email captured), bio.subscribed (bio page signup), bio.unsubscribed (bio page unsubscribe), message.received (dm received), conversation.needs_reply (needs a reply), ai.draft_created (reply drafted), comment.received (comment received), post.published (post published), post.failed (post failed), broadcast.finished (broadcast finished), prospect.opener_sent (outreach opener sent), prospect.replied (prospect replied), prospect.window_closing (prospect's reply window closing), campaign.goal_reached (campaign goal reached). The event reference shows each payload.
Quickstart: your first webhook
The quickest way to see an event arrive takes about five minutes and needs no server of your own.
Get a URL that shows what it receives
Open webhook.site and copy your unique URL. Later you'll use your own endpoint or a Zapier catch hook instead.
Add it as a webhook in CueDM
In Settings → Integrations, choose Add webhook, paste the URL, tick DM sent, and save. Copy the signing secret now, because CueDM only shows it once. You need it to verify requests.
Send a test
Choose Send test on the webhook. A
pingevent arrives within a few seconds:Request body{ "id": "cmg4x0x6d0001l50g8m2k1v7q", "event": "ping", "workspaceId": "cmfz8o3gq0000l50gk3ah2d9e", "occurredAt": "2026-09-29T10:00:00.000Z", "data": { "message": "Hello from CueDM" } }Trigger a real event
Comment your automation's keyword on your own post from another account. When the DM goes out, a
dm.sentevent arrives with the automation, the account, the person and what they wrote.
Your first API request
On Studio, create a key in Settings → Integrations → API keys, then ask CueDM which workspace it belongs to:
curl https://cuedm.com/api/v1/me \
-H "Authorization: Bearer $CUEDM_API_KEY"Authentication covers keys, rate limits and errors.
Conventions
- The base URL is
https://cuedm.com/api/v1. Requests and responses are JSON. - A successful response is the resource itself, with a
2xxstatus. A failed one has anerrorobject with acodeand amessageyou can show to a person. - Times are ISO 8601 in UTC, for example
2026-09-29T10:00:00.000Z. - IDs are opaque strings. Store them as they are and don't parse them.
- New fields may be added to responses and payloads at any time, so ignore fields you don't use. A field is never removed or renamed without notice.
Working with an AI assistant?
Every page has Copy page at the top, which copies it as Markdown to paste into Claude, ChatGPT or Cursor. Coding agents can start from /docs/llms.txt, an index of these docs made for them, and the OpenAPI document, which lists every endpoint and field. In Settings → Integrations, Copy prompt on each card copies a ready-made prompt with your workspace's details.
Who can set this up
Only workspace owners and admins can add webhooks and create or revoke API keys. If those buttons are missing in Settings, ask an owner to do it or to make you an admin.
Stuck, or something here is wrong? Email support@cuedm.com and a person will answer.