If you're building an external tool, running automations, or want to create short links without opening the dashboard every time, the MakerManifest API is built for you. This guide walks through setup, authentication, and the most useful endpoints.
Who is this for?
The API is available on Premium plans and above. It's designed for creators who want to integrate MakerManifest short links into:
- External apps or tools (like NoteSmith, Notion integrations, etc.)
- Scripts and automations (bulk link creation, scheduled jobs)
- Browser extensions or bookmarklets
- Zapier/Make-style workflows via custom webhooks
Step 1: Generate an API key
Go to Dashboard → API Access. Click New Key, give it a descriptive name (e.g. "My Script" or "NoteSmith Integration"), and click Create.
Copy the key immediately. It's shown exactly once. Store it as an environment variable — never hardcode it in source code that might be committed to a public repo.
Premium accounts can have 1 active key at a time. Enterprise accounts can have up to 10 active keys — useful for separate apps, environments, or team members. You can revoke any key individually at any time.
Step 2: Authenticate requests
All API requests require your key in the Authorization header as a Bearer token:
Authorization: Bearer mm_your_key_hereEvery endpoint returns 401 Unauthorized if the key is missing, revoked, or invalid.
Step 3: Create a short link
The most common operation — create a short link for any URL:
curl -X POST https://makermanifest.co/api/v1/links -H "Authorization: Bearer mm_your_key_here" -H "Content-Type: application/json" -d '{"url":"https://notesmith.io/some-page"}'Response:
{
"id": "abc123",
"code": "xK9mP2",
"url": "https://notesmith.io/some-page",
"shortUrl": "https://mkr.ms/xK9mP2",
"clickCount": 0,
"createdAt": "2026-05-19T00:00:00.000Z"
}The shortUrl is ready to use immediately. It resolves using your preferred short domain (set in Dashboard → Settings).
Optional: Use a custom code
To request a specific vanity code instead of a random one, add a code field:
curl -X POST https://makermanifest.co/api/v1/links -H "Authorization: Bearer mm_your_key_here" -H "Content-Type: application/json" -d '{"url":"https://notesmith.io/blog","code":"ns-blog"}'The code must be unique. If it's taken you'll get a 409 Conflict.
List your links
curl https://makermanifest.co/api/v1/links -H "Authorization: Bearer mm_your_key_here"Returns a paginated list of your URL-type short links. Use ?page=2&limit=50 to paginate (max 200 per page).
Get stats for a single link
curl https://makermanifest.co/api/v1/links/xK9mP2 -H "Authorization: Bearer mm_your_key_here"Delete a link
curl -X DELETE https://makermanifest.co/api/v1/links/xK9mP2 -H "Authorization: Bearer mm_your_key_here"Check who you are
curl https://makermanifest.co/api/v1/me -H "Authorization: Bearer mm_your_key_here"Returns your account info (username, plan, preferred domain).
Your affiliate rules still apply
Links created via the API go through the same redirect system as links created in the dashboard. Your affiliate rules are applied at click time — so your Amazon Associates tag, AWIN rules, and any custom rules all work exactly as they do for dashboard-created links. You never need to modify URLs before passing them to the API.
Full endpoint reference
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/me | Your account info |
| GET | /api/v1/links | List your short links |
| POST | /api/v1/links | Create a short link |
| GET | /api/v1/links/{code} | Get stats for a link |
| DELETE | /api/v1/links/{code} | Delete a link |
Have a use case the current API doesn't support? Vote on the roadmap or message @help — the API is actively expanding.