Skip to main content

​
n8n

The PoYo community node for n8n lets workflows submit PoYo tasks, wait for results, and resume from signed PoYo callbacks. It uses the same API key, model catalog, task statuses, and results as the REST API. Source and sample workflows: PoyoAPI/poyo-n8n.

​
Requirements

  • An n8n instance that allows Community Nodes
  • A PoYo API key from the API key page

​
Install

1

Install the community node

In n8n, open Settings → Community Nodes → Install and enter n8n-nodes-poyo. Searching for “PoYo” in the node panel should then show the PoYo nodes.
2

Create the credential

Open Credentials → New credential → PoYo API, paste your API key, keep the default Base URL https://api.poyo.ai, and click Test.
3

Run a sample workflow

Download a sample workflow, choose Import from File in the n8n workflow menu, select your PoYo credential, and run it.

​
Sample workflows

The webhook sample relies on PoYo’s signed callbacks. See Webhook Callbacks for the signature headers.

​
Notes

  • The API key is stored in the n8n credential, not in exported workflow files.
  • Requests call the PoYo REST endpoints directly and include an X-PoYo-Source header to identify the integration.
  • Tasks use the standard statuses not_started, running, finished, and failed.

​
Troubleshooting