Keep creator API specifications easy to find
Give useful creator API documentation a clear home. A scheduled review can prompt Notis to create a specification entry when an endpoint is ready to document.
Trigger
Recurring schedule
Notis starts this workflow on a schedule, such as daily, weekly, or during business hours.
Action
Create a Spec
Tool to create an API specification in Postman's Spec Hub. Use when you need to create single or multi-file specifications in a workspace. Supports various spec types including OpenAPI 3.0, OpenAPI 3.1, and AsyncAPI 2.0.
Why this helps
Endpoint notes spread across conversations are hard to maintain and easy to forget when work changes hands.
- Create a dedicated specification entry for a documented creator API.
- Make API documentation easier to locate during handoffs.
- Capture a clearer starting point for future endpoint changes.
Setup
Build it in a few focused steps.
- 1Connect Just One API and Postman to Notis once through the portal.
- 2Create an automation with one instruction that names the creator endpoint and describes the specification to create in Spec Hub.
- 3Choose a recurring review schedule and a channel for run reports.
- 4Test using one real endpoint and review the specification before sharing it.
Questions about this workflow
Should the specification be considered verified automatically?
No. Review its contents against the endpoint behavior and authoritative documentation before treating it as accurate.
Can this avoid duplicate specifications?
Describe the existing specification to reuse and tell Notis to create one only when a suitable entry does not already exist.
When this happens · Trigger
Do this · Action
Supported Triggers and Actions
Notis builds workflows that link Just One API to Postman. A trigger fires from one place; an action lands in another.
Just One API triggers
Postman actions
Recurring trigger
Notis starts this workflow on a schedule, such as daily, weekly, or during business hours.
Create a Collection
Tool to create a new Postman collection in a specific workspace or the default workspace. Use when you need to create a collection with workspace specification. For complete collection format details, refer to the Postman Collection Format documentation.
Webhook trigger
Notis starts this workflow when an external tool or custom backend sends an HTTP request.
Create a Collection Comment
Tool to create a comment on an API's collection. Use when you need to add a comment to a specific collection within an API. To create a reply on an existing comment, include the thread_id in the request.
Create Collection from Schema
Tool to create a collection from a schema and link it to an API with specified relations. Note: This endpoint is deprecated in Postman v10 and higher. Use when you need to generate a collection from an API schema and establish relations like contract tests or documentation.
Create a Folder
Tool to create a folder in a Postman collection. Use when you need to organize requests by creating a new folder within a collection. For complete details, see the Postman Collection Format documentation.
Create a Folder Comment
Tool to create a comment on a folder. Use when you need to add a comment to a specific folder in a collection.
Create a Fork
Tool to create a fork from an existing collection into a workspace. Use when you need to fork a collection to create an independent copy in a specific workspace.
Create Environment Fork
Tool to create a fork from an existing environment into a workspace. Use when you need to fork an environment to a specified workspace.
Create a Mock Server
Tool to create a new mock server in a Postman collection. Use when you need to create a mock server to simulate API endpoints for testing or development. Returns the created mock server's details including the mockUrl which can be used to make requests.
Connect any two apps with Notis in the middle.
Just One API and Postman, or any other combination from 1,000+ integrations.
When this happens · Trigger
Do this · Action
Save your first hour today.
7-day trial of any paid plan, with 20$ of usage included.
No card. Works with personal or business Postman.