Skip to main content

​
Overview

You can create links to Ninja that automatically prefill a message in the text input. This is useful for:
  • Sharing a task prompt with a colleague
  • Embedding contextual links in emails, docs, or internal tools
  • Creating quick-action buttons that start a specific workflow
The format is identical to ChatGPT’s ?q= parameter: 
https://ninja.new/?q=Your+message+here

​
How it works

When a user opens a Ninja link with a ?q= query parameter, the message is automatically placed in the text input so they can review it before submitting.

​
URL format

https://ninja.new/?q={URL-encoded message}
The message must be percent-encoded. Spaces can be encoded as %20 or +.

​
Examples

LinkMessage
https://ninja.new/?q=Connect%20my%20Shopify%20storeConnect my Shopify store
https://ninja.new/?q=Write+a+product+description+for+my+new+sneakersWrite a product description for my new sneakers
https://ninja.new/?q=Analyze%20my%20top%2010%20selling%20productsAnalyze my top 10 selling products
const message = 'Help me set up Google Ads for my store';
const url = `https://ninja.new/?q=${encodeURIComponent(message)}`;
Use this tool to generate a prefilled Ninja link:
The user must be logged in to Ninja to submit the message. If they are not logged in, they will be redirected to the login page first.