Skip to main content
Use this guide to integrate Alter with other apps using URL schemes.

Video Tutorial

Introduction

Alter supports x-callback-url so apps can trigger actions in each other. You can:
  • trigger Alter actions from external apps
  • trigger external app actions from Alter
  • pass input data in URLs
  • return back to the originating app (depending on app support)

How It Works

  1. Trigger Alter actions from another app via alter://... URLs.
  2. Trigger external app actions from Alter using that app’s URL scheme.

Trigger Alter Actions From External Apps

  1. Open Action Editor.
  2. Select an action.
  3. In General, copy the URL from the URL Callback section.
  4. Paste the URL into another app (browser, notes, shortcuts, etc.).
Alter Callback URLs

Trigger External App Actions From Alter

  1. Create a clickable URL in Alter using the target app scheme.
  2. Format parameters exactly as required by that app.
  3. Click to run and verify action behavior.

Examples

Alter callback examples

Cross-app example

  • Bear note creation:
    • bear://x-callback-url/create?title=Demo%20Note

Supported Apps (Sampling)

Apps with x-callback-url or URL-scheme support include:

Testing And Troubleshooting

  • Verify the URL scheme and parameters.
  • URL-encode special characters.
  • Confirm the target app supports the action.
  • Paste the app’s callback documentation URL into Alter to ground syntax/rules.