Capture Download
Capture icon Roam Research icon

Quick capture for Roam Research

Quick Notes for Roam Research

Use Capture as a fast inbox before an idea becomes a note in Roam Research. Append captured text or a link as a block in a Roam Research graph, on today’s daily note or a named page, optionally nested under a block.

To send a capture to Roam Research, open Capture Settings, choose Export, and add Roam Research as a destination. Enter the graph name as it appears in its URL, after /app/. In Roam, open Settings > Graph > API Tokens, create a token with append or edit access, and paste it into Capture. Optionally enter a page title and a block to nest captures under. Text and phone captures become one block with the trimmed text. Links become a Markdown link with the fetched page title, or the bare URL when no title is available. Roam Research is offered as a destination for Text and Links captures.

A quick capture workflow for Roam Research

  1. 01Catch it

    Write or share the thought into Capture while it is fresh.

  2. 02Keep moving

    Save the Capture without stopping to organize the destination.

  3. 03Send to Roam Research

    Use your configured export action when the capture is ready.

What gets sent to Roam Research

  • Text and phone captures become one block with the trimmed text.
  • Links become a Markdown link with the fetched page title, or the bare URL when no title is available.
  • With Page blank, the block goes to today’s daily note in the device’s time zone.
  • With Nest under set, the block is added under that top-level block.
  • Capture uses Roam’s Append API, which also works with encrypted graphs.

Set up Roam Research in Capture

  1. Open Capture Settings, choose Export, then tap Configure if this is your first destination or Add new destination.
  2. Choose Roam Research from the app picker.
  3. Enter the graph name as it appears in its URL, after /app/.
  4. In Roam, open Settings > Graph > API Tokens, create a token with append or edit access, and paste it into Capture.
  5. Optionally enter a page title and a block to nest captures under.
  6. Review the destination name and icon, then tap Save.

Supported Capture types

This destination appears only for content it can receive.

TextLinks

Fields and options

Field or optionWhat it changes
Graph nameRequired; the graph name from its URL, after /app/.
Graph tokenRequired token with append or edit access.
PageOptional page title; blank uses today’s daily note. Roam creates the page if it does not exist.
Nest underOptional text of a top-level block, for example [[Capture]]. Roam creates the block if it does not exist.

Example: a quick capture to Roam Research

Leave Page blank and set Nest under to “[[Capture]]”. Exporting a reading note adds it as a block under [[Capture]] on today’s daily note.

Send the capture

  1. Open an existing Capture and choose its configured Roam Research export action.
  2. Capture sends the supported type directly to Roam Research and shows a success toast when the API request completes.

Limits and troubleshooting

Limits

  • Images and files are unsupported.
  • Each export adds one block; Capture does not split multi-line text into separate blocks.
  • Blocks are appended through the API without opening Roam Research.

Troubleshooting

  • If Capture rejects the destination, fill in both the graph name and the graph token.
  • If Roam refuses the export, check that the token was created in that graph and has append or edit access.
  • If the block lands on the wrong daily note, check the device’s time zone.

More places for quick notes

Agenda iconAgenda Apple Notes iconApple Notes Bear iconBear

Checked against Capture 3.5, last verified 12 November 2026.