canonical: https://jentic.com/apis/malma.ai/malma

# malma Workspace API

Jentic publishes the only available OpenAPI specification for malma Workspace API, keeping it validated and agent-ready. The malma Workspace API is the official surface for the Make.com and Zapier integrations with malma.ai. It provides two workspace-scoped endpoints: list the agents available in a workspace and create a new lead inside it. Authentication uses a bearer token tied to the workspace.

## For AI agents

List malma.ai workspace agents and create new leads inside a workspace. Used by automation workflows that hand qualified leads off from a website, form, or chat experience to a malma agent.

## Scope

Does not handle outbound calling, agent training, or workspace administration - use for listing workspace agents and creating leads only.

## Capabilities

- List every agent configured in a malma workspace with their IDs and metadata
- Create a new lead in a workspace and route it to a chosen agent
- Pass enrichment fields on the lead so the malma agent can personalise outreach
- Drive the lead-creation step from a Make.com or Zapier scenario
- Look up workspace agent IDs to validate downstream automation configuration

## Use cases

### Webform-to-Malma Lead Handoff

Marketing teams that capture leads on a website want them to reach a malma.ai voice or chat agent immediately. The malma create-lead endpoint accepts the lead's contact and enrichment fields plus the target agent ID, so a webform handler can POST the lead the moment the form is submitted. The agent then picks up outreach without any human in the loop.

Example prompt: POST `/workspace/create-lead` with the form fields and the target SDR agent ID, then verify the lead lands in the workspace.

### Make.com or Zapier Workflow

The malma API is built for no-code automation tools. A Make.com or Zapier scenario can list the workspace agents to populate a dropdown for non-technical users, then create the lead against the selected agent on a downstream trigger. This is the canonical integration path for the malma platform.

Example prompt: GET `/workspace/agents` to populate the dropdown, then POST `/workspace/create-lead` with the user-selected agent ID and the trigger payload.

### Chat-Qualified Prospect Routing

Live chat tools that qualify visitors can hand off the qualified prospect to a malma voice or chat agent for follow-up. The create-lead endpoint accepts the qualification metadata as part of the lead body so the malma agent picks up the conversation with full context.

Example prompt: On chat qualification, POST `/workspace/create-lead` with the conversation summary in the lead's enrichment fields and the SDR agent ID.

### AI Agent Lead Generation Loop

Outbound and inbound agents can generate leads in malma as part of a wider workflow. Through Jentic the agent searches by intent, loads the schema, and executes the create-lead call while the workspace bearer token stays in the vault. The narrow API surface makes it ideal for agent-as-tool patterns.

Example prompt: Use Jentic to search 'create malma lead', execute POST `/workspace/create-lead` with the resolved contact and target agent, and return the new lead ID.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/workspace/agents` | Get workspace agents |
| POST | `/workspace/create-lead` | Create lead |

## Key resources

- **Agents** — List the agents configured in the workspace.
- **Leads** — Create a new lead in the workspace and route it to a chosen agent.

## Why Jentic

- **Setup:** Wiring the malma Workspace API by hand means managing its bearer token, targeting the app.malma.ai/api host, and handling its agent-listing and lead-creation calls yourself. Through Jentic you install once, import malma from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** malma exposes two operations, listing workspace agents and creating a lead, with the lead details carried in the request body, so limit the agent to the operations it needs, such as reading the agent list, and add lead creation only when you want it. The operation set is your choice.
- **Credential handling:** Your malma Workspace API token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'list workspace agents' or 'create a lead', and Jentic returns the matching malma operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **HubSpot Account Info API** — HubSpot stores the broader CRM record while malma drives the agent-led outreach.
- **Pipedrive API** — Pipedrive is a competing CRM that exposes its own lead and deal endpoints for SDR-style workflows.
- **Calendly API** — Calendly schedules the meeting that follows once a malma agent qualifies a lead.

## FAQ

### Why is there no official OpenAPI spec for malma Workspace API?

malma does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call malma Workspace API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the malma Workspace API use?

malma uses HTTP bearer authentication scoped to a workspace. Through Jentic the bearer token is stored encrypted in the vault and attached at execute time, so the agent never sees the raw token.

### Can I create a lead through the API?

Yes. POST `/workspace/create-lead` with the contact details and the target agent ID. The agent picks up the lead inside the workspace once the call returns.

### How do I find the right agent ID to route a lead to?

Call GET `/workspace/agents` to list every agent in the workspace, then pick the agent whose name or persona matches the routing rule for the lead.

### What are the rate limits for the malma Workspace API?

Rate limits are not declared in the OpenAPI spec - they depend on the malma plan attached to the workspace. Check the malma.ai dashboard before sending high-volume lead bursts.

### How do I create a lead through Jentic?

Run pip install jentic, search 'create malma lead', load the schema for POST `/workspace/create-lead`, and execute with the contact details and target agent ID. Jentic injects the bearer token from the encrypted vault.

### Can I limit what my agent is allowed to do with the malma Workspace API?

Yes. Because you run Jentic One yourself, your own rules decide which malma operations and credentials the agent may use. The malma Workspace API exposes just two operations, listing workspace agents with GET `/workspace/agents` and creating a lead with POST `/workspace/create-lead`, so you can allow the agent to read the agent list only and add lead creation with POST `/workspace/create-lead` solely when you want it. The operation set the agent can call is your choice.