Blog

How to Use Nomad Pipeline Audio to Draft
Ever found yourself perched on a windy mountain peak with an incredible story bursting out of your chest, or standing on a chaotic street corner in the middle of a breaking news story, only to realize… you don’t have a laptop or the patience to type thousands of words on a tiny phone keyboard?

Enter Nomad Pipeline Audio to Draft—the WordPress plugin designed to turn your spoken voice notes into clean, well-structured, publication-ready draft posts directly in the Gutenberg Block Editor.

Whether you’re on the trail, commuting, or capturing rapid thoughts between meetings, this guide will get you set up and dictating like a pro in minutes!

Who Is This For? (Use Cases)

You don’t need a degree in computer science to use Nomad Pipeline Audio to Draft. It’s built for content creators, storytellers, and busy folks who think out loud:
- 🥾 Hikers & Outdoor Enthusiasts: Record audio logs, waypoint descriptions, or gear thoughts while navigating trails without dropping your trek poles to type.
- ✈️ Travel Bloggers & Digital Nomads: Speak your city guides, restaurant reviews, and travel observations while walking through bustling markets or relaxing on long bus rides.
- 📰 Field & Mobile Journalists: Dictate raw observations, field reports, or interview summaries on location and instantly turn them into structured drafts.
- 🚗 Commuters & On-the-Go Creators: Turn idle driving time or walking sessions into productive brainstorming and post-drafting time.
- ✍️ Bloggers & Content Writers with Writer’s Block: Banish “blank cursor syndrome” by simply talking out your ideas—the plugin converts spoken rambling into organized heading and paragraph blocks!
Under the Hood: Native WordPress 7.0 AI Power

Nomad Pipeline Audio to Draft takes full advantage of WordPress 7.0 core features:
1. WordPress Client AI: The plugin leverages native AI Connectors built into WordPress 7.0. This means processing is handled safely through your configured WordPress AI providers without cluttering your setup with third-party tracking scripts or bloat.
2. Abilities API: The plugin registers a native WordPress Ability:
  - Ability Name:
    nomad-pipeline-audio-to-draft/audio-to-post
  - Endpoint:
    /wp-json/wp-abilities/v1/abilities/nomad-pipeline-audio-to-draft/audio-to-post/run
Pro Tip for Developers & Automation Geeks: Because it registers a standard Ability via the Abilities API, you can trigger this pipeline from external automation tools (like iOS Shortcuts, Zapier, Make, custom scripts, or mobile audio upload workflows) to create WordPress drafts remotely!

Step-by-Step Guide: Installation to First Published Post

Step 1: Requirements Check

Before diving in, make sure your environment is ready:
- WordPress 7.0+
- PHP 8.0+
- At least one active WordPress AI Connector configured on your site.
Step 2: Plugin Installation
1. Go to your WordPress Dashboard and navigate to Plugins > Add New.
2. Search for Nomad Pipeline Audio to Draft (or upload the .zip file if installing manually).
3. Click Install Now, then click Activate.
Configuring Global Settings

Once activated, establish your default editorial preferences so you don’t have to re-enter them every time.

Nomad Pipeline Audio to Draft settings
1. Navigate to Settings > Nomad Pipeline Audio to Draft in your admin sidebar.
2. Configure your global defaults:
  - Default Language: Select your site’s main language (e.g., English US, Italian, Spanish, etc.).
  - Default Tone: Choose the default voice style (Professional, Neutral, or Conversational).
  - Default Target Length: Set your standard post depth (Short, Medium, or Long).
  - Proper Noun Hints: Enter frequently mentioned terms, brand names, technical jargon, or local place names (e.g., WordPress, Gutenberg, Sydney, Ténéré 700) separated by commas. This gives the AI exact spelling guidance for tricky names!
  - Insertion Mode: Select Append (adds generated blocks below existing content) or Replace (swaps out current content). Append is recommended to keep existing notes safe.
3. Click Save Changes.
Creating a Post from Audio in the Gutenberg Editor

Now for the magic! Here is how to create a draft in real time using a voice recording:

1. Open the Block Editor

Create a New Post (or open an existing draft) in WordPress.

2. Open the Nomad Pipeline Sidebar

In the top right corner of the editor, click the Audio Converter icon (or find it in the Plugin Sidebar panel) to open the control panel.

Nomad Pipeline Audio to Draft sidebar

3. Select Your Audio File

Click Select Audio from Media Library. You can pick an existing file or upload a fresh recording straight from your phone or voice recorder app.
- Supported Audio Formats: MP3, OGG, WAV, M4A, AAC, FLAC.
Select audio source from the Media Library

4. Adjust Per-Post Settings (Optional)

Override your global settings for this specific article if needed:
- Target Language
- Tone & Target Length
- Specific Proper Noun Hints (e.g., unique names relevant only to this post)
- Insert Mode (Append vs. Replace)
Editorial options

5. Hit Generate!

Click Generate Draft from Audio. Sit back for a few seconds while the plugin processes your recording through the AI engine, normalizes the structure, and generates native Gutenberg blocks (headings, paragraphs, bullet points).

Generating content

6. Review & Publish

Watch as headings and paragraphs appear right on your canvas!
- Fine-tune any formatting or text as desired.
- Add images, banners, or tags.
- Click Publish (or Schedule) when you’re satisfied!
Are you ready to leave the desk behind and blog from anywhere in the world? 🎧🌍
July 28, 2026
Testing the Nomad Pipeline Audio to Post Endpoint: A Step-by-Step Guide
The Nomad Pipeline Audio to Draft plugin for WordPress allows you to automatically transform an audio file from your Media Library into a structured draft post using AI. Our plugin registers an ability that converts an audio file into post content via the Abilities API. This allows you to send HTTP requests from an external app or service to run the ability automatically.

We use Postman to run clean, repeatable, and automated tests against our endpoints.

This guide will show you exactly how to set up your environment, securely manage authentication, execute a happy-path request, and automate response capture.

Prerequisites Checklist

Before firing up Postman, verify that you have these pieces ready:
- An active WordPress 7.0+ site running over HTTPS.
- The Plugin installed and active on your test environment.
- A WordPress account with the edit_posts capability (Editor or higher is recommended).
- An Application Password generated from your WordPress user profile screen (do not use your regular login password).
- An audio file pre-uploaded to your Media Library (note its ID).
Setting Up Your Postman Environment

When building API workflows, reproducibility is everything. Hardcoding URLs and credentials into your requests makes your collection brittle and creates security risks. Instead, we use a Postman Environment to separate operational parameters from sensitive tokens.

Step 1: Create the Environment

Create a new environment in Postman

In Postman, create a new environment and populate it with these keys:

Variables vs. Secrets
- Regular Variables: These are structural values that change depending on your environment or test case. Examples include base_url, media_id, and external_run_id.
- Sensitive Variables (Secrets): These are authorization credentials. In Postman, mark your wp_user and wp_app_password as secret type variables. This masks their values on screen and prevents you from accidentally leaking them.
Add variables and secrets for your environment

💡 Pro-Tip on external_run_id: This ID is crucial for Idempotence—the guarantee that submitting the exact same request multiple times won’t accidentally spin up duplicate processing jobs or clone your posts. For a fresh test, bump the suffix (e.g., -001, -002). To test if your server correctly handles duplicates, deliberately resend the request with the exact same ID.

Step 2: Configure the main POST request

Create an HTTP request and connect it to your Environment

Create a new HTTP request and select your environment from the menu located in the top-right corner of Postman.

Next, let’s build the primary execution request.
- Method: POST
- URL: {{base_url}}/wp-json/wp-abilities/v1/abilities/nomad-pipeline-audio-to-draft/audio-to-post/run
- Headers: Content-Type: application/json
Configure the HTTP request

Step 3: Setting Up Authentication

Do not inject credentials manually into your JSON payload or headers. Instead:
1. Click on the Authorization tab of your request.
2. Select Basic Auth from the Type dropdown.
3. In the Username field, type: {{wp_user}}
4. In the Password field, type: {{wp_app_password}}
Postman will securely encode these variables behind the scenes into a standard HTTP Authorization header.

Setting up Basic Auth for your request

Step 4: The request body payload

Switch to the Body tab, select raw, and set the format type to JSON. Then paste the following request payload:
```
{
  "input": {
    "contract_version": "1.0.0",
    "external_run_id": "run-ext-20260721-002",
    "source": "api",
    "audio": {
      "media_id": 134
    },
    "editorial_options": {
      "language": "en-US",
      "tone": "professional",
      "target_length": "medium",
      "temperature": 0.3
    },
    "proper_noun_hints": [
      "WordPress",
      "OpenAI",
      "Nomad Pipeline"
    ],
    "publish_options": {
      "status": "draft"
    }
  }
}
```
Important: the request payload must be wrapped inside input as an object. If you send fields at the root level, the API returns ability_invalid_input (for example: input is not of type object).

Setting the request body payload

Understanding the Key Parameters
- audio: This field accepts a single input strategy. In our example, we pass a native media_id. Alternatively, the API accepts a signed_url or a raw base64 payload accompanied by a mime_type. Never mix these strategies in a single request!
- proper_noun_hints: A highly practical list of custom terms, brands, or unique names. This tells the underlying AI model exactly how to spell industry-specific or personal terms properly during transcription and writing.
Verify the WordPress backend: If the response is pending or processing, poll again using your run workflow until it reaches completed. Then grab the generated post_id, open your WordPress admin dashboard, and verify the document exists with your expected settings (for example, saved as draft).

Troubleshooting and Verification Checklist

When checking your results, use this clean workflow to verify success or isolate failures:

Verify the WordPress Backend: Once a request returns a completed status, grab the generated post_id, open your WordPress admin dashboard, and ensure the document exists with your specified settings (e.g., saved safely as a draft).
Handle 401 rest_forbidden errors: If you encounter this, your application password configuration is hitting a snag. Ensure you didn’t include extra trailing spaces when copying the password, and double-check that your server isn’t stripping HTTP Authorization headers before they reach WordPress.
Isolate test failures: If you encounter unexpected system errors, don’t blindly resend the exact same data. Always assign a fresh, distinct value to external_run_id in your environment parameters to start a completely isolated, clean pipeline test.

Common 400 errors

ability_invalid_input with message input is not of type object: your payload is missing the input wrapper.
ability_invalid_input with message about source (or other required fields): one or more required fields inside input are missing.

July 21, 2026

Journey Across Andalusia: From Úbeda to Seville via Córdoba

Morning Departure from Úbeda

Our journey today began in the historic town of Úbeda in the early morning hours. As we set out onto the open road, the air carried a noticeable chill that served as a crisp wake-up call for the day's route ahead. Leaving behind the architectural landmarks of the town, we set our course westward toward our midday stop in Córdoba.

The early portion of the drive gave us an immediate sense of the expansive terrain of southern Spain. Even as the early chill lingered, the open skies promised clear traveling conditions as we transitioned away from the elevated areas of the province of Jaén and made steady progress toward the lower plains of the Guadalquivir river basin.

Midday Respite and Local Flavors in Córdoba

Around midday, we pulled into Córdoba for a scheduled lunch break and a brief opportunity to stretch our legs. The pause was well worth it, as we treated ourselves to a classic Spanish lunch consisting of an exceptional bocadillo with jamón. The simple yet high-quality local ham provided the perfect fuel before we prepared for the second half of our daily transit.

While our time in the city was short, the stop provided a welcome interruption to the driving routine, allowing us to recharge comfortably before getting back on the motorway for the afternoon stretch.

Highway Driving Conditions and Speed Enforcement

From a purely technical driving perspective, the route offered very little variation or excitement. The entire stage was completed along modern multi-lane motorways, which favored efficiency and steady transit over winding scenic curves or challenging maneuvers.

Drivers traveling along this corridor should maintain close awareness of speed regulations, as active radar enforcement was a consistent factor throughout the entire journey.

Entire route completed along standard multi-lane motorways
Predictable, uniform driving environment with few technical challenges
Frequent speed cameras (autovelox) positioned along major transit corridors

Geographical Context: The Andalusian Corridor

Today's stage traversed the heart of Andalusia, the southernmost autonomous community of peninsular Spain. Our route crossed three distinct provinces within the region, descending gradually across the agricultural basin carved out by the Guadalquivir River.

Geographically, the journey highlights the diverse topography of Andalusia, shifting from the elevated rolling olive groves of eastern Jaén to the flatter, sun-drenched agricultural plains that surround Córdoba and Seville.

Autonomous Community: Andalusia (Spain)
Provinces traversed: Jaén, Córdoba, and Seville
Key geographical feature: Guadalquivir River depression and central Andalusian plains

Afternoon Arrival in Seville and Shifting Weather

We arrived on the outskirts of Seville in the middle of the afternoon, greeted by a substantial change in weather conditions. The morning chill had completely dissipated, replaced by significant regional heat as temperatures climbed to approximately 30 degrees Celsius around the provincial capital.

Once settled into Seville, we spent an enjoyable and lively evening filled with laughter, good conversation, and vibrant city atmosphere. The relaxed evening provided an ideal conclusion to a straightforward day of cross-regional driving.

Looking Forward: The Crossing into Morocco

Reflecting on the day, the stage served as an interesting and necessary link connecting the interior provinces of Andalusia with its regional capital. The steady progress enabled us to cover considerable ground smoothly while observing the changing terrain.

All eyes are now turned toward tomorrow's itinerary, which will mark a major milestone in our broader expedition as we conclude our travel through Spain and undertake the crossing to Morocco.

April 15, 2026

Motorbike Diary: Day Two Across Spain from Albarracín to Úbeda

Overview of Day Two on the Road

April 14 marks the second official day of our motorcycle expedition across Spain. Traveling alongside a group of four friends, this stage of the journey delivered exceptional scenery, open riding conditions, and remarkable shifts in the regional geography. The route took us from the historical settlement of Albarracín, through a scheduled rest stop in Alcaraz, and culminated in the town of Úbeda.

Compared to the opening leg of the trip, which covered nearly 440 kilometers, today’s ride was slightly shorter at nearly 400 kilometers. Despite the long distance in the saddle, the riding conditions remained virtually unmatched. The roads throughout this corridor presented optimal surfaces with practically no vehicular traffic, allowing for continuous, unrestricted motorcycle touring through varied topographies.

Route Highlights: Roads and Olive Groves

One of the standout elements of the day was the visual spectacle of the changing landscapes. After departing the rugged interior, the stretch between Alcaraz and Úbeda offered an extraordinary panorama dominated by endless olive groves. Hectares upon hectares of cultivated olive trees stretched across rolling terrain as far as the eye could see, creating an impressive agricultural expanse that defines this particular sector of the Iberian Peninsula.

The overall transit experience was defined by smooth curves, expansive vistas, and clear asphalt, making it one of the most rewarding segments of the entire tour so far.

Date of travel: April 14 (Day 2 of the Spanish motorcycle tour).
Travel group: Five riders in total (the narrator traveling with four companions).
Distance logged: Nearly 400 kilometers on Day 2, following almost 440 kilometers on Day 1.
Primary waypoints: Departure from Albarracín, intermediate stop at Alcaraz, arrival and overnight in Úbeda.
Notable scenery: Vast expanses of cultivated olive groves between Alcaraz and Úbeda.

Geographical and Regional Breakdown

As requested during the journey, an analysis of the route confirms that the itinerary crossed three distinct autonomous communities of Spain: Aragon, Castilla-La Mancha, and Andalusia. Each territory exhibits clear geographical, climatic, and structural characteristics along the way.

Aragon (Starting Point: Albarracín)

The day began in the province of Teruel within the southern reaches of Aragon. The area surrounding Albarracín is characterized by mountainous highlands, limestone cliffs, deep gorges, and the rugged terrain of the Sierra de Albarracín. This region features elevated altitudes, cooler microclimates, and sparse population density, providing twisting mountain roads ideal for technical motorcycle riding.

Castilla-La Mancha (Midway Segment: Alcaraz)

Descending southwest from Aragon, the route entered Castilla-La Mancha, crossing into the province of Albacete where the intermediate stop of Alcaraz is located. Castilla-La Mancha is defined primarily by the expansive Meseta Central plateau, broad horizons, arid plains, and transitioning mountain foothills such as the Sierra de Alcaraz. It represents a vast, open interior zone marked by traditional agricultural estates, open skies, and sweeping, empty thoroughfares.

Andalusia (Destination: Úbeda)

The final section of the day brought the group across the regional border into Andalusia, terminating in Úbeda within the province of Jaén. Jaén is globally recognized as the capital of olive oil production, which explains the endless hectares of olive plantations encountered in the approach to Úbeda. Topographically, northern Andalusia transitions from the foothills of the Sierra Morena into the fertile Guadalquivir river valley, combining gentle rolling hills with rich agricultural land and UNESCO World Heritage urban centers.

Summary of Progress

With nearly 840 total kilometers logged over the first two days, the tour has seamlessly connected the mountainous heart of Aragon, the open plains of Castilla-La Mancha, and the agricultural foothills of Andalusia. Day two stands out for its serene, empty roads and the breathtaking agricultural panorama leading into Úbeda.

April 14, 2026

Riding Spain’s Best Curves: A Motorcycling Adventure from Barcelona to Albarracín

Setting Off on the First Spanish Leg

On April 13, our long-awaited motorcycle journey through Spain officially commenced. Setting out from the vibrant city of Barcelona, our group of five good friends embarked on what would quickly prove to be one of the most thrilling riding experiences of our lives. Exploring new landscapes on two wheels always brings a distinct sense of freedom, but taking on the open roads of eastern Spain elevated our enthusiasm to an entirely new level.

Embarking on a multi-day motorcycle expedition requires good planning, reliable machinery, and great companions. Departing Barcelona early in the morning gave us ample time to leave the busy urban traffic behind and head inland toward the picturesque regions of Spain. As the city skyline faded in our mirrors, the landscape shifted dramatically into rolling hills, sweeping valleys, and inviting asphalt.

Discovering Morella: A Medieval Wonder

Our initial major stop along the route was the historic town of Morella. Nestled dramatically in the countryside, Morella is a breathtaking medieval village surrounded by imposing ancient stone walls and topped by a majestic fortress. Arriving in the village after hours of continuous riding provided a welcome break and allowed us to explore its magnificent architectural layout.

The standout feature of Morella was undoubtedly its splendid cathedral. Stepping inside, we were genuinely amazed by the cathedral’s architectural beauty and serene atmosphere. It is the kind of unexpected gem that makes motorcycle touring so rewarding. Stopping in Morella allowed our group to stretch our legs, soak in the historical charm of the medieval streets, and appreciate the rich cultural heritage that Spain offers beyond its major metropolitan hubs.

The Ride to Albarracín: Hundreds of Kilometers of Pure Excitement

After enjoying our time in Morella, we geared up once again and set our sights on Albarracín, our designated overnight destination. The leg of the journey connecting these regions offered some of the finest motorcycle riding imaginable. For hundreds of kilometers, the highway unwound into a continuous sequence of fast, sweeping curves through stunning natural scenery.

For any passionate motorcycling enthusiast, this specific itinerary is an absolute must-ride. The combination of pristine asphalt, dynamic road geometry, and breathtaking scenic vistas creates an unforgettable riding rhythm. The sheer joy of leaning through long, fast turns against a backdrop of striking Spanish terrain made this stretch of the journey feel truly extraordinary.

Navigating Speed Limits and Staying Safe on Spanish Roads

While the route is an absolute dream for motorcycle riders, it also demands considerable discipline and constant focus. The open stretch of road and wide, fast-paced curves naturally tempt riders to twist the throttle. It is remarkably easy to find yourself cruising well above 120 kilometers per hour, even though the posted speed limits across these roads generally range between 80 and 90 kilometers per hour.

Maintaining awareness of your speed is critical for two major reasons: rider safety and strict law enforcement. Speed cameras are heavily deployed throughout the region. These automated enforcement systems are positioned across various points along the road, meaning unmindful speeding can quickly lead to heavy fines. Enjoying the incredible curves while keeping your velocity within legal and safe parameters ensures that the trip remains exciting without unnecessary safety risks or unwanted penalties.

Highlights of the Route

Planning a similar motorcycle tour requires balancing ride dynamics, historic stops, and road awareness. Here are the core highlights gathered from our first leg through Spain:

Historic Pitstops: Exploring Morella’s medieval streets and its stunning, surprising cathedral.
Overnight Destination: Resting in Albarracín, one of Spain’s most characteristic and picturesque villages.
Sublime Riding Roads: Experiencing hundreds of kilometers filled with fast, engaging curves and breathtaking panoramic views.
Road Safety Caution: Staying vigilant regarding speed limits (80 to 90 km/h) and frequent automated speed enforcement cameras.

Conclusion: An Essential Itinerary for Every Motorcyclist

Reaching Albarracín as evening approached brought an ideal end to an unforgettable day on the road. Settling into this remarkably characteristic town allowed us to reflect on a spectacular journey from Barcelona. Between the exhilarating fast curves, stunning historical landmarks like Morella Cathedral, and the camaraderie shared among Bicio, Pacchio, Enrico, Pasquale, and myself, this first Spanish leg exceeded every expectation.

If you are a motorcycle enthusiast searching for a route that combines technical riding pleasure with captivating scenic beauty and cultural history, this Spanish itinerary comes with the highest recommendation. Just remember to keep an eye on your speedometer, stay alert for speed cameras, and enjoy every single kilometer of the ride.