---
{
  "title": "Integrations",
  "intro": "Connect thousands of applications to Workflowy"
}
---

# When to use

**Integrations** in Workflowy let you bring content in (and eventually connect more deeply) by linking Workflowy with other tools you already use. For example:

- Sync your reading highlights via **Readwise** so they appear in Workflowy automatically.
- Use **Zapier** to send events, emails, tasks, or RSS entries into Workflowy without manual copying.
- Tap into the **Workflowy API** to build custom automations or integrations.

In short: Integrations let Workflowy become a central hub - capturing your digital life from other apps so you stay in flow.

# **Integrations**

Send information automatically to Workflowy from thousands of applications with our integrations.

# **Readwise sync**

Sync your reading highlights from Readwise directly into Workflowy.
Connect your Readwise account and import all your book highlights, article clips, tweets, and podcast notes as a structured hierarchy.

{% steps %}
1. Visit [readwise.io/access_token](https://readwise.io/access_token) to get your readwise token
2. Visit [https://workflowy.com/integrations/readwise/](https://workflowy.com/integrations/readwise/) to paste your readwise token
3. Press '**Connect to readwise**'
{% /steps %}

{% kb_image src="https://cdn.prod.website-files.com/608aecd1e643ecaa961a7a67/68c45fd0fbca35a21a968d0f_readwise.png" alt="" %}{% /kb_image %}

# **API**

A basic API that lets you connect Workflowy to other applications and flows. Development not included.

{% steps %}
1. Visit [https://beta.workflowy.com/api-reference/](https://beta.workflowy.com/api-reference/)to learn about the API
2. Write your code and integrate it with Workflowy!
{% /steps %}

{% kb_image src="https://cdn.prod.website-files.com/608aecd1e643ecaa961a7a67/68c462216d0f972bdebc3aa9_workflowy%20api.png" alt="" %}{% /kb_image %}

# **Send content to Workflowy with Zapier**

**Currently, you can only send content to Workflowy. We plan to allow sending from Workflowy later.**

Create a Zap that sends content to a new item upon receiving a trigger event from a third-party app.

Connect third-party apps to Workflowy using Zapier, and unlock nearly limitless possibilities for capturing your ideas, tasks, notes, and research material.

**Note**: Before you begin -

- Create or log in to your Zapier account.
- Know how to make a Zap. If you're unsure, check out the [Create your first Zap](https://zapier.com/resources/guides/quick-start/create-zap) guide

1. Start by creating a new Zap in Zapier and set the 'Trigger' event (e.g. new task in Todoist). When you've done this, your Zap should look like this. Click 'Continue'.

{% kb_image src="https://uploads-ssl.webflow.com/608aecd1e643ecaa961a7a67/662c5a6e2c22a8f121ed5db4_655f4a1d75114c208fda0454_1.%20Trigger%20added-p-800.png" alt="" %}{% /kb_image %}

2. Next, you'll define the 'Action' step using Workflowy. Search for and select 'Workflowy" in the 'Change Action' screen.

{% kb_image src="https://uploads-ssl.webflow.com/608aecd1e643ecaa961a7a67/662c5a84f43e83e0b795ef7e_655f48c2cf3914fc107495c9_2.%20Change%20action-p-800.png" alt="" %}{% /kb_image %}

3. Under 'App & Event,' choose the 'Create bullet' event and click 'Continue.'

{% kb_image src="https://uploads-ssl.webflow.com/608aecd1e643ecaa961a7a67/662c5af1f7a15fba9169d278_655f4ab3f124a319c9248be0_3.%20App%20%26%20event-p-800.png" alt="" %}{% /kb_image %}

4. In the 'Account' section, click or tap 'Sign in' and follow the pop-up instructions. Need help? Read '[How do I get a Workflowy API key?](https://workflowy.com/learn/integrations/#troubleshooting-and-faqs-for-zapier)'.

{% kb_image src="https://uploads-ssl.webflow.com/608aecd1e643ecaa961a7a67/662c5b0731a6f350c9881438_655f48c2685e349bb907710e_4.%20Paste%20key-p-800.png" alt="" %}{% /kb_image %}

5. When your account is connected, add a save location URL in the 'Action' section.  You can leave this empty, and new bullets will be saved to your Workflowy 'Home.' Need help? Read ['How do I get a Workflowy save location URL?'](https://workflowy.com/help/integrations/#get-save-url).

{% kb_image src="https://uploads-ssl.webflow.com/608aecd1e643ecaa961a7a67/662c5b2729d45f08ffb959c1_655f4ab3d7a37c17a77cf6a1_5.%20Save-url-p-800.png" alt="" %}{% /kb_image %}

6. Next, specify the content to be included in your bullet and its note.

{% kb_image src="https://uploads-ssl.webflow.com/608aecd1e643ecaa961a7a67/662c5b3f068a0deaa09696b3_655f48c312676700f5c099af_6.%20Title%20%2B%20note-p-800.png" alt="" %}{% /kb_image %}

7. Finally, test the action, click 'Publish,' and your setup is complete.

{% kb_image src="https://uploads-ssl.webflow.com/608aecd1e643ecaa961a7a67/662c5b58de6d4a5a1b9c1db4_655f4ab31538b20b1753ed31_7.%20Test%20%2B%20publish-p-800.png" alt="" %}{% /kb_image %}

> **Note:**zaps can take anywhere from 1 - 15 minutes to run depending on your zapier subscription level.

# Troubleshooting and FAQs for Zapier

#### **How do I get and use a Workflowy API key?**

> 1. Visit this page: [https://workflowy.com/api-key](https://workflowy.com/api-key)
> 2. Generate the Workflowy API key, and click 'Copy'.

{% kb_image src="https://uploads-ssl.webflow.com/608aecd1e643ecaa961a7a67/662c5c4b68c6566dc24f19b5_655f517cec34edcc8c4b9b4c_API%202.%20API%20key-p-800.png" alt="" %}{% /kb_image %}

> 3. Return to the Zapier 'Connect' pop-up, paste the API key into the text field, and click 'Yes, Continue...'.

{% kb_image src="https://uploads-ssl.webflow.com/608aecd1e643ecaa961a7a67/662c5b0731a6f350c9881438_655f48c2685e349bb907710e_4.%20Paste%20key-p-800.png" alt="" %}{% /kb_image %}

> 4. Your Zap is now connected to Workflowy. The green check in your Zap shows this. No green check? See the Troubleshooting section below.

{% kb_image src="https://uploads-ssl.webflow.com/608aecd1e643ecaa961a7a67/662c5c822c22a8f121ef3000_655f520d6420e55c825d1f95_API%203.%20Account-p-800.png" alt="" %}{% /kb_image %}

> **Note:** Your API key won't expire. To protect the security of your account, do not share your API key with others.

# **How do I get a Workflowy save location URL?**

You can choose where your Zap will create new bullets. This is useful for sending different types of content to different locations (e.g. new ideas to an 'Inbox' bullet, project tasks to a shared Workflowy Board, or using Workflowy as an RSS reader).

**There are two ways to get a bullet URL:**

> **A.** Navigate to your preferred Workflowy save location and copy the browser URL or use 'Copy item URL' from the item menu.

{% kb_image src="https://uploads-ssl.webflow.com/608aecd1e643ecaa961a7a67/662c5cc02e2074187d9540fd_655f54db7f6439f2a0c7580b_save-url-1-p-800.png" alt="" %}{% /kb_image %}

> **B.** Select 'Copy item URL' from the item menu on any item.

{% kb_image src="https://uploads-ssl.webflow.com/608aecd1e643ecaa961a7a67/662c5ce62e3e9cd2ad26945d_655f54dbe6277e3be843e713_save-url-2-p-800.png" alt="" %}{% /kb_image %}

# **Can I use a shared node as a save location?**

> Yes, you can use. Follow the method described in 'How do I get a Workflowy save location URL?' above. You'll need 'Can edit' permissions or higher. Learn more in this [Sharing](https://workflowy.com/help/sharing/) article.

# **Zapier is showing me an error message**

**"This auth is expired. Please reconnect it here."**or**"Authentication failed: The app returned "Invalid Credentials, try again."**

- Visit: [https://workflowy.com/api-key](https://workflowy.com/api-key#)
- Copy and paste your Workflowy API key into the Zapier 'Connect' pop-up.
- If that doesn't work, view the Workflowy API key page again, delete your existing key, create a new one, and paste that into Zapier.

**"Save location URL is invalid"**or**"Save location not found"**Check that you've added a valid Workflowy URL ('e.g https://workflowy.com/#/x2f8ae43c8fb'). Still stuck? See [How do I get a Workflowy save location URL?](https://workflowy.com/help/integrations/#get-save-url)

**"Permission denied"**You'll need 'Can edit' permissions or higher to save to a shared bullet. Ask the owner to change your access permissions. Learn more in this [Sharing](https://workflowy.com/help/sharing/) article.

**"Monthly item quota used"**You've reached your Free account monthly bullet limit. [Upgrade your account](https://workflowy.com/pricing/) to Pro for unlimited bullets.

**"Rate limit reached"**A Zap can only send a maximum of 100 new bullets every minute. Make sure the 'Trigger' event isn't firing more than 100 times per minute or the 'Action' step isn't creating more than 100 new bullets at once.

**"Your Gmail data can only be sent to approved apps"**Google has set up security restrictions that prevent most Zapier apps from accessing free Gmail accounts ending with @gmail.com and @googlemail.com.

Want to send emails from an @gmail.com or @googlemail.com account? Use our '[Gmail emails](https://workflowy.com/integrations/gmail-emails/)' template.

# Zapier templates

We have a growing collection of zapier templates ready for you to use to get started sending information to Workflowy in our [integrations library](https://workflowy.com/integrations).

Got a request for a Zap or made a cool Zap that you want to share? [Share your zap with us](https://docs.google.com/forms/d/e/1FAIpQLSeUGdVia7qc6uo4RVC21WOjL3pvTYSu5GRouVfYMNIRhQg7pw/viewform).

#### Still need help?

Check the 'Zaps' section on [Zapier's service status](https://status.zapier.com/) page. If there are no reported issues, [contact Workflowy support](mailto:help@workflowy.com).

# Apple shortcuts

Our Apple shortcut lets you quickly send information to Workflowy from your Mac desktop or iOS devices. You can combine Apple shortcuts with [Siri](https://support.apple.com/en-us/105020) to capture notes hands-free.

Apple shortcuts work on macOS, iOS, iPadOS, and watchOS.

Learn more about Apple Shortcuts on [iOS](https://support.apple.com/guide/shortcuts/welcome/ios), and [Mac](https://support.apple.com/guide/shortcuts-mac/intro-to-shortcuts-apdf22b0444c/mac).

1. Open the [Apple shortcut link](https://www.icloud.com/shortcuts/90c3566e8b204777b608368c103b72c2)
2. Click '[Get Shortcut](https://www.icloud.com/shortcuts/90c3566e8b204777b608368c103b72c2)' button to save the shortcut
3. The Apple shortcuts app will open, click 'Add shortcut...'
4. Input your [Workflowy API key](https://workflowy.com/api-key/)
5. Enter the Workflowy URL where you want to save content
6. Click '**Add Shortcut**' to save your API key and save location
7. Trigger the shortcut with siri by saying 'Hey Siri, save my idea'
> You can now speak and whatever you say will be saved to your Workflowy account.
> **Note**: You can also trigger this shortcut from the menubar of your Mac desktop.