Tourwriter Minim Integration Guide


Here are a few of the terms we’ll use throughout this guide, with their meanings.

Agent Anyone logging into the Tourwriter system. That’s you!
Traveller Someone that you sell direct to, or a person travelling on an itinerary you’ve sold to a Key Contributor
Tourwriter The Tourwriter application and database
Minim The title for the new online platform by Tourwriter
Agent Portal This is where you’ll log into to view your list of itineraries pushed from Tourwriter to Minim, manage your image gallery and set your preferences.
Online Itinerary The digital version of your itinerary created in Minim that is shared with your traveller
Proposal The proposed itinerary.
Accepted itinerary This is when your customer has accepted the proposal itinerary but all the bookings are still not confirmed.
Final The final (confirmed/in-country) itinerary.

Supported Browsers

Our online itinerary platform supports Google Chrome (Google Chrome auto-updates, so you most likely already have the latest version), Firefox, Safari and Edge.

Setting up Tourwriter

When you have your itinerary ready to be pushed to the online platform, please ensure that the Assigned To field in the Itinerary tab of your itinerary has the correct Tourwriter user chosen. A new itinerary is tailored to include the current Tourwriter user as the default assignee. This can be seen when the current user’s username appears in the Assigned to field in the Itinerary tab of the itinerary.  The Drop-down options in the Assigned to field maps to the Tourwriter users added in the Tools > Setup > User accounts area.

The Tourwriter user whom the itinerary is assigned to can have a corresponding Contact Card allocated to them. Clicking Contact details in the Manage user accounts workspace opens up the user’s contact card which can also be accessed from the Contacts section.

When you click Contact details for a Tourwriter user who hasn't been assigned a contact card, a Tourwriter message pops up that allows you to create a new contact card.

It is recommended that each Tourwriter user has a corresponding contact card created. Doing so will link the First name, Last name and Email 1 field from the contact card in Classic to contact details that appear in the Booking process section of the new online platform.

Setting up your account

You will be sent an email containing your Minim API key (for Tourwriter).

In Tourwriter

Open any Itinerary.

  1. Click on the Bookings > List tab
  2. Click Tools
  3. Select Push itinerary to online...

On the Upload Itinerary to Online screen

  1. Click on the Push to drop-down.
  2. Select Minim

Before you push the itinerary to the online platform, click Settings to configure your Minim setup. The Minim Setup window will open:

Here is where you will set up the Push to Minim for your database. When signing up, you will have been provided with your unique API User Key. Please copy and paste this into the line at the top of the window (refer to the screenshot below) ensuring there are no extra spaces at the end of the key.

How to get your API User key

To get your API key, log in Minim and navigate to your account section.

Types Subtab

Once you enter the unique API user key, move on to the Types subtab under the Mappings workspace. Here you need to map your Local Service Types to the Remote Service Types categories in Minim. This means, that you will be “telling” Tourwriter which category to display your information in. For example, if you have a Breakfast service type, map it to Meal as shown in the screenshot below. The Local Type represents the Service Types loaded in Tourwriter, and the Remote Type field (hover over the field and use the drop-down list) includes the list of available types in Minim.

Statuses Subtab

Next, you need to map your local Itinerary statuses in Tourwriter to remote statuses in Minim. Itinerary status (local status) describes the overall status of an Itinerary at any one point in time, For example, Quotation, Confirmed - Finalised and so on. In the Minim Setup window, you will see your existing Itinerary status list under the Local Status filed. Use the drop-down menu under the Remote Status field to link your Tourwriter Itinerary Status to either Proposal, Accepted or Final in Minim.

Content rules

The Content Rules Engine allows you to define exactly which publishing content is pushed to Minim. You can create numerous templates for the different stages of your itinerary creation process, as well as set different rules for different languages or audiences.

Content Rule Template Setup

  1. On the Bookings List, go to Tools > Push itinerary to Minim…
  2. Click Content rules…
  3. The Content rule setup window will appear.
  4. On the left, under Rule Templates, click the Yellow plus sign and give your template a name. E.g. Quotation or Final Itinerary.

  1. On the right, click the Yellow Plus sign to Create new Content rule record.

  1. Use the drop-down options to specify the Service Type name, whether you want to display Supplier or Service level content for that Service Type, Content Type and whether you want a Publishing Quick Note displayed before or after the publishing content, or not at all.

  1. Click Save Template.
  2. Add additional Rule Templates by following steps 4-7.

  1. Back on the Upload Itinerary to Online screen, select the Template Name from the Choose Content rule template drop down before Pushing an Itinerary to Minim.

An example of a Content Rule Template is included below:


In the above image, we are looking at the Quotation Template.

Accommodation– The first line shows that accommodation publishing content will be used in the new online platform. It will use the Supplier Level content, which is publishing content that is loaded for the overall Supplier(rather than a Service option).  It will use the Quotation Content type, which is the content loaded for quotations (rather than final documents etc). Any accommodation publishing notes will come Before the publishing content.

Activity– Activity publishing content will be used in the new online platform. It will use the Service Level content, which is publishing content that is loaded for a specific Service (rather than an overall Supplier). It will use the Quotation Content type. Any activity publishing notes will come Beforethe publishing content.

Transfers– Transfer publishing content will be used in the new online platform. It will use the Service Level content, which is publishing content that is loaded for a specific Service (rather than an overall Supplier). It will use the Quotation Content type. Any transfer publishing notes will come Afterthe publishing content.

The Sort Order field allows for additional content of the same type to be ordered, if for example, you would like to publish both a Supplier Level and Service Level description for Accommodation.

Only those Content Types mapped in your Content Rules template will appear on the client’s itinerary. This allows you to customise the content that you share with your traveller or agent at each stage of the itinerary creation process.

Log into Minim

Log into with your username and password provided to you by email. Once you are logged in, you will enter the Agent Portal. All itineraries are displayed on this page. That’s it, you are now ready to push your first itinerary from Tourwriter to the online platform.

Pushing an itinerary to Minim

In Tourwriter Classic, open any Itinerary.

  1. Click on the Bookings >List tab
  2. Click Tools
  3. Select Push itinerary to online...

On the Upload Itinerary to Online screen

  1. Click on the Push to drop-down.
  2. Select Minim

Choose Content rule template

Each time you push an itinerary to Minim, you will need to choose the Content rule template to use, as setup during the Content Rules setup process outlined above.  Your default Content rule template will be pre-selected.

Refresh all images

When this option is ticked, all images will be refreshed, even if they have already been uploaded. Untick this option if you would not like to refresh your images in Minim.

Create a new online version

This option creates a new version of the itinerary in Minim. It will be automatically ticked (and greyed out) if the Itinerary has not been Pushed to the online platform yet.

If you are updating an existing itinerary, this option will be automatically unticked, so the existing itinerary in the online platform will be updated. Tick this option to create a new version of the same itinerary.


This box is a Passive field which simply lets you know what is happening with the Upload. You will see the stages of the upload and when the upload is complete.


This will open the Setup Itinerary Push Window. For more information about this, please refer to Setup above.

Open Online

This feature allows you to open the itinerary in your browser. If you are already logged into the online platform, you will be taken directly to the Itinerary Page. If you would like to see the updated version, please wait for the upload to finish, before opening.

  1. Select Upload and your view of the Online Itinerary will open directly in your browser, ready for you to apply the Hero image & logos, before sharing with your traveller. 

Still need help? Contact Us Contact Us