{
  "schema_version": "agentpmt.docs.v1",
  "generated_at": "2026-07-27T23:06:32.229Z",
  "release_id": "9bd28307d3dc8ff05bcac2f755a96681a9e650091caba4ab5ecbd5a1d6d62acc",
  "id": "69b2e500c481ec10adab7ce4",
  "page_url": "https://www.agentpmt.com/docs/getting-started/quick-start",
  "markdown_url": "https://www.agentpmt.com/docs/getting-started/quick-start?format=agent-md",
  "json_url": "https://www.agentpmt.com/docs/getting-started/quick-start?format=agent-json",
  "source_path": "content/docs/quick-start.mdoc",
  "updated_at": "2026-07-21T18:55:15.327Z",
  "headings": [
    {
      "depth": 2,
      "id": "connect-a-credential",
      "title": "Connect a credential"
    },
    {
      "depth": 2,
      "id": "build-and-test-a-workflow",
      "title": "Build and Test a Workflow"
    },
    {
      "depth": 2,
      "id": "create-a-hosted-agent",
      "title": "Create a Hosted Agent"
    },
    {
      "depth": 2,
      "id": "run-on-a-schedule",
      "title": "Run On a Schedule"
    },
    {
      "depth": 2,
      "id": "audit-the-run",
      "title": "Audit the Run"
    },
    {
      "depth": 2,
      "id": "where-to-next",
      "title": "Where to next"
    }
  ],
  "related_products": [],
  "related_workflows": [],
  "doc": {
    "title": "Quick Start",
    "description": "Get a workflow live in minutes — connect a credential, build and test the workflow, create a Hosted Agent to run it, put it on a schedule, and audit the run.",
    "category": "Getting Started",
    "image": null,
    "full_path": "getting-started/quick-start",
    "body_markdown": "# Quick Start\n\nThis guide takes you from an empty account to a scheduled, audited workflow in five steps. You will connect a credential, build and test a workflow, create a Hosted Agent to run it, put it on a schedule, and audit the run.\n\nEach step builds on the last, so do them in order the first time through. If you already have some of these pieces in place, skip ahead.\n\n## Connect a credential\n\nA credential is the secret your agent uses to call an external service — an API key, an OAuth token, or similar. Not every tool needs one, but any tool that hits a service requiring your own account will. You create the credential once, then bind it to the Agent Group that will run the workflow.\n\n### Open the Credentials tab\n\nIn the dashboard, go to the **Credentials** tab and click **Add**.\n\n![AgentPMT dashboard showing the Credentials tab where credential records are created and managed](https://www.agentpmt.com/docs-assets/images/screenshots/credentials/1-credentials-dashboard.05d1001dbd2d.png)\n\n_Open the Credentials tab in the dashboard._\n\n### Choose the credential type and fill in the fields\n\nPick the credential type the tool expects (for example, an API key). Secret fields are masked after you save and are never displayed back. See [Credentials](https://www.agentpmt.com/docs/core-concepts/how-credentials-work) for what each type means.\n\n![AgentPMT credential type picker showing the available credential types to choose from](https://www.agentpmt.com/docs-assets/images/screenshots/credentials/2-credentials-choose-one.6dfd271f2051.png)\n\n_Choose the credential type the tool expects._\n\n### Bind the credential to your Agent Group\n\nIn your Agent Group settings, bind the credential to the tool that needs it. AgentPMT injects the secret server-side at call time — your agent never sees the raw value.\n\n![AgentPMT Agent Group settings showing where to connect a credential to the group](https://www.agentpmt.com/docs-assets/images/screenshots/credentials/3-connect-to-agent-group.26af26768f38.png)\n\n_Connect the credential to the Agent Group that will run the workflow._\n\n![AgentPMT credential picker showing a credential being chosen and connected to an Agent Group](https://www.agentpmt.com/docs-assets/images/screenshots/credentials/4-choose-and-connect.6dff9626d73c.png)\n\n_Choose the credential and connect it to the group._\n\n**Not sure if you need a credential?**\n\nIf your first tool does not require one (many don't), skip ahead to the next step and come back here when a tool asks for one.\n\n## Build and Test a Workflow\n\nA workflow chains several tools into a reusable recipe that runs in one go — for example, \"search the web, scrape the top results, summarize, and email me.\" You build it once, then attach it to an agent or call it directly.\n\n### Open the Workflow Builder\n\nGo to the [Workflow Builder](https://www.agentpmt.com/agent-workflow-skills-builder?mode=workflow). It opens in Workflow mode with a blank canvas.\n\n### Name it and describe the outcome\n\nGive the workflow a name and a one-sentence description of what it should produce. The description is what an agent reads to decide when to use the workflow, so be concrete.\n\n### Drop in tool nodes and connect them\n\nFrom the sidebar, search the marketplace and click a tool to add it as a node. Drag a line from one node's output to the next node's input to set both the execution order and the data flow.\n\n### Configure each node's inputs\n\nClick a node to open its config panel. Each input can be a literal value, a reference to an earlier node's output, or a workflow input that gets filled in at run time.\n\n### Test it from the canvas\n\nRun the workflow from the canvas. Each node lights up as it executes, and errors surface on the node that produced them. Test tools that need a credential only after you have bound it to the Agent Group.\n\n### Publish or keep private\n\nClick **Publish** to share it to the marketplace, or keep it private. Either way it is now available to attach to an agent. See [Build a Workflow](https://www.agentpmt.com/docs/getting-started/build-a-workflow) for the full walkthrough.\n\n## Create a Hosted Agent\n\nA Hosted Agent runs inside AgentPMT. You build it once, then use it from the dashboard, the website, the mobile app, or via API. It decides on its own which tool or workflow to use based on your message.\n\n### Open the Agent Builder\n\nGo to the [Agent Builder](https://www.agentpmt.com/agent-workflow-skills-builder?mode=agent), or open the [marketplace](https://www.agentpmt.com/marketplace) and click **Build custom agent** at the top.\n\n### Name your agent and write a one-line description\n\nThe description tells the agent how to behave. Be concrete: \"Runs the daily research workflow and emails me the summary\" beats \"research helper.\"\n\n### Attach your workflow (and any tools)\n\nFrom the canvas **Catalog**, click **Add workflow** on the workflow you just built. Add any individual tools you want the agent to call directly.\n\n### Try it in the scoped chat\n\nScroll to the **Scoped chat preview** section and click **Open Chat**. Ask the agent to do something that uses your workflow. You should see the tool calls appear in the conversation and a corresponding entry in **Control Center → Agent Activity**.\n\n**Start with one workflow**\n\nAttach one workflow first, confirm a chat call goes through end to end, then add more.\n\n## Run On a Schedule\n\nInstead of triggering the workflow by hand each time, put it on a schedule and AgentPMT runs it on a recurring basis — daily digests, hourly checks, weekly reports.\n\n### Open Schedules\n\nGo to **Control Center → Workflows → Schedules**.\n\n### Create a schedule for your workflow\n\nThe schedule attaches to the Agent Group that runs the workflow, so it can only target workflows that group can access — workflows you added explicitly, public workflows, or private workflows granted to the group.\n\n### Choose how it runs\n\nWith an AgentPMT managed run, AgentPMT's own runner executes the workflow on schedule using the model assigned to it. (You can also bring your own scheduler that claims due items from a queue — see [Using Workflows and Tools](https://www.agentpmt.com/docs/getting-started/using-workflows-and-tools) for that path.)\n\n### Test the schedule\n\nUse **Test Run** to fire the workflow once with the stored prompt without advancing the next due time. Confirm it produces the output you expect.\n\n**Keep enough credits**\n\nFor an AgentPMT managed run, the account owner must hold at least 100 credits or the occurrence is skipped with a low-credit notice. Top up before the schedule fires to avoid gaps.\n\n## Audit the Run\n\nEvery call your agent and workflows make is recorded. Use the activity log to audit a specific run, confirm whether it consumed credits, or export usage for review.\n\n### Open Agent Activity\n\nGo to **Control Center → Agent Activity**. Each row is one tool call with its cost, duration, and status.\n\n### Filter to the run you care about\n\nFilter by Agent Group, time window, or status to narrow down to the scheduled run you want to inspect.\n\n### Expand a row for the full request and response\n\nExpand any row to see the full request and response. This is where you confirm the workflow did what you expected and spot any failures.\n\n### Export if needed\n\nClick **Export to CSV** to pull the filtered activity out for review or record-keeping.\n\n---\n\n## Where to next\n\n### [Using Agents](https://www.agentpmt.com/docs/getting-started/using-agents)\n\nRun your agent from the dashboard, the marketplace, mobile, or API.\n\n### [Using Workflows and Tools](https://www.agentpmt.com/docs/getting-started/using-workflows-and-tools)\n\nAttach workflows, manage schedules, and troubleshoot runs.\n"
  }
}