Open Nav

Quick Account Setup on Ideal Postcodes

Step by step guide on creating an Ideal Postcodes account, creating a key and enabling automated top-ups

Updated 7 Apr 2020

Quick Setup

You can create a live API Key to drop into your integration in minutes to begin address search and validation. The minimum steps to do this are:

  1. Create an account
  2. Create an API key
  3. Enable automated top-ups

Your account is required to manage your API Key(s), billing and licensing.

An API Key is required to authenticate yourself against our service. It's a long sequence of characters (e.g. ak_k8pnfoj02I55011CRYDz0ZAwqltQT) commonly passed to your development team or dropped into an integration. Each API Key requires a Key Balance to perform live address searches.

By enabling automated top-ups you can ensure your key is topped up when the balance runs low. You will be informed by email if an automated top-up takes place.

Step 1: Account Set Up

Sign up for an account at Ideal Postcodes by clicking on the Sign Up link on the home page.

Sign up

Authorise your account, by clicking on the link on the left sidebar of your dashboard.

Authorise your account

On the next page, enter your details and agree to our Terms of Service.

Terms of Service

Step 2: Create an API Key

Create an API Key from your dashboard

Create API key

Go back to your dashboard. You will be be able to see your API key. The long sequence of characters (e.g. ak_k8pnfoj02I55011CRYDz0ZAwqltQT) represents your API Key.

Click on the blue Manage button to access your key dashboard. From there you can edit security, notifications and other settings.

Manage button

For instance, you can apply a name to your key via the Key Information panel. Click on the Edit Name button and amend accordingly.

Edit key name

Step 3: Enabling Automated Top-Ups

Click on the Billing tab on the left side bar on your dashboard.

From there, add a payment method and click on Save Card. If successful, you should see a Payment Method panel with your card details.

Payment method

Scroll down the page to the Automated Top-Ups section. Enable Automated Top-Ups by selecting a top-up plan and your payment method.

Automated Top-Ups

Click on Enable and confirm that you wish to enable automated top-ups. This should now be reflected in the Automated Top-Ups section.

Successful top-up addition