Tips and tricks

Use consistent parameter names

Conduit works best when different source apps send the same kinds of data using the same parameter names. Good defaults are title, text, content, tags, date, and source.

conduit://capture?title=Meeting%20notes&text=Follow%20up&tags=work

Load the sample payload

Use Load Sample Payload on the main screen to test routes without leaving Conduit. This fills Payload History with sample values you can use immediately.

Auto-run one or more routes

Add a short name to a route, then include it in the inbound URL.

conduit://capture?title=Idea&text=Follow%20up&route=drafts

To run multiple routes, use routes with comma-separated short names.

conduit://capture?title=Idea&text=Follow%20up&routes=drafts,things,bear

Extract tags from text

Add extractTags=true to move trailing hashtags from text into the tags parameter.

conduit://capture?text=Follow%20up%20%23work%20%23next%20action&extractTags=true

Conduit turns this into text of Follow up and tags of work, next action.

Add metadata inside a text field

If your source app can only send one text field, add a final metadata block. Conduit removes the block from the text and turns each line into a parameter.

Follow up with Alex

---
tags: work, follow-up
route: drafts

You can also use final lines such as:

::tags=work, follow-up
::route=drafts

Use fallback values

Fallbacks fill in a value when the incoming payload does not include that token.

{{category|Inbox}}

Format text

Templates can apply simple text formatting.

{{title::trim}}
{{title::lowercase}}
{{title::uppercase}}
{{tags::compact}}

compact removes extra spaces around separators such as commas, semicolons, pipes, and slashes.

Format dates

Use date formatting when a target app expects a specific date format.

{{date::yyyy-MM-dd}}
{{date::dd/MM/yyyy|today}}
{{date::yyyy-MM-dd|today+7}}

Use callbacks for chained workflows

If a target app supports success callbacks, map {{callbackSuccessURL}} to the app's callback parameter. A successful callback can provide values such as {{item-link}}, {{callback-message}}, and {{callback-url}} for a follow-up route.

Preview before triggering

After selecting a payload, each route shows the generated outbound URL. Check this preview before triggering a route, especially when building a new mapping.

Duplicate routes to experiment

Use Duplicate when you want to try a variation of an existing route. Conduit creates a copy with unique route details so the original remains available.