---
title: "LinkedMash Developer Portal"
description: "Build with the LinkedMash REST API, OpenAPI specification, MCP server, webhooks, and agent skills."
canonical: "https://www.linkedmash.com/developers"
last-updated: "2026-08-22"
---

# LinkedMash Developer Portal

> Build with the LinkedMash REST API, OpenAPI specification, MCP server, webhooks, and agent skills.

LinkedMash gives developers and AI agents access to the authenticated account’s saved LinkedIn posts, labels, drafts, scheduling, and analytics. Start with read-only bookmark requests, then add write operations only when the workflow requires them.

## Start here

- [REST API quickstart](https://www.linkedmash.com/api-docs/getting-started): Create an API key, authenticate, and make your first request to the LinkedMash REST API.
- [OpenAPI 3.1 specification](https://www.linkedmash.com/openapi.json): Machine-readable contract for 21 public operations, including typed inputs, responses, and authentication.
- [MCP server](https://www.linkedmash.com/api-docs/mcp-integration): Connect Claude, ChatGPT, Cursor, Codex, or another MCP client to LinkedMash tools.
- [Webhooks](https://www.linkedmash.com/api-docs/webhooks): Receive signed events when saved posts, labels, schedules, and integrations change.
- [Agent quickstart](https://www.linkedmash.com/api-docs/agent-quickstart): Choose REST, MCP, or an agent skill based on the client and workflow you are building.
- [LinkedMash agent skill](https://www.linkedmash.com/api-docs/skills): Install the first-party skill so compatible coding agents can use LinkedMash with less setup.

## Authentication

For new server-side agents, exchange an API key ID and secret for a short-lived OAuth 2.0 client-credentials token with only the required scopes. Existing integrations may continue sending the API key as `Authorization: Bearer <key>` or in the `linkedmash-api-key` header.

## First request

```bash
curl https://api.linkedmash.com/v1/bookmarks?limit=5 \
  -H "Authorization: Bearer <your-linkedmash-api-key>"
```

The API uses production account data. LinkedMash does not currently provide a separate sandbox, so begin with GET requests or a dedicated development account.

## Machine-readable resources

- [AI Catalog](https://www.linkedmash.com/.well-known/ai-catalog.json): application/ai-catalog+json
- [OpenAPI specification](https://www.linkedmash.com/openapi.json): application/json
- [RFC 9727 API catalog](https://www.linkedmash.com/.well-known/api-catalog): application/linkset+json
- [API authentication guide](https://www.linkedmash.com/auth.md): text/markdown
- [API versioning and deprecation policy](https://www.linkedmash.com/api-versioning.md): text/markdown
- [OAuth authorization server metadata](https://www.linkedmash.com/.well-known/oauth-authorization-server): application/json
- [OAuth protected resource metadata](https://www.linkedmash.com/.well-known/oauth-protected-resource): application/json
- [MCP discovery manifest](https://www.linkedmash.com/.well-known/mcp.json): application/json
- [Live MCP endpoint](https://www.linkedmash.com/.well-known/mcp): application/mcp
- [MCP server card](https://www.linkedmash.com/.well-known/mcp/server-card.json): application/json
- [Agent Skills index](https://www.linkedmash.com/.well-known/agent-skills/index.json): application/json
- [Agent Plugin manifest](https://www.linkedmash.com/.well-known/agent-plugin.json): application/json
- [Agent skill](https://www.linkedmash.com/SKILL.md): text/markdown
- [Agent site map](https://www.linkedmash.com/llms.txt): text/plain
- [Developer llms.txt](https://www.linkedmash.com/developers/llms.txt): text/plain
- [XML sitemap](https://www.linkedmash.com/sitemap.xml): application/xml
- [LinkedMash source and agent configuration](https://github.com/RamyaChinnadurai/linkedmash)
- [@linkedmash/mcp on npm](https://www.npmjs.com/package/@linkedmash/mcp)

Canonical portal: https://www.linkedmash.com/developers