Skip to content
Ideal Postcodes logo

Connectors / Data and analytics · HTTP Connector

Automate Ideal Postcodes with Tray.ai

Ideal Postcodes is a UK address lookup service for finding, autocompleting, and cleaning postal addresses, with email and phone number validation.

What can you do with Ideal Postcodes on Tray.ai?

Ideal Postcodes is a UK address lookup service for finding, autocompleting, and cleaning postal addresses, with email and phone number validation. Tray.ai connects to Ideal Postcodes through the HTTP Connector, so your workflows can call the Ideal Postcodes API alongside the rest of your stack.

  • Cleanse an address on every new customer record before it reaches your shipping system.
  • Validate a phone number when a lead comes in so sales calls the right number.
  • Look up a postcode from a web form and fill the full address into your CRM.
  • Validate an email address before a new contact is added to your marketing lists.
Connects through
HTTP Connector
Authentication
A bearer token or an API key in the query string
Base URL
https://api.ideal-postcodes.co.uk/v1

Set it up

Connect Ideal Postcodes to Tray.ai

Each step uses Ideal Postcodes's own API details, from its documentation.

Step 1

Save Ideal Postcodes's API token

Save the token Ideal Postcodes issues as a Tray.ai authentication. The HTTP Client sends it as a bearer token on every call. The token stays out of the workflow and out of the logs.

Step 2

Point the HTTP Client at the API

Add an HTTP Client step and use https://api.ideal-postcodes.co.uk/v1 as the base URL. Or paste a cURL example from Ideal Postcodes's API docs, and Tray.ai fills in the method, URL, and headers.

Step 3

Start with “Look up a postcode”

It's one of 13 documented actions, under Addresses. The response comes back as data the next step can map into your other apps.

Step 4

Hand it to an AI agent

Wrap “Find an address” and “Resolve an address” in workflows, and Tray.ai's Agent Gateway for MCP publishes them as governed tools Claude and other AI agents can call.

Workflows to build with Ideal Postcodes

Each one uses actions and events from Ideal Postcodes's own API documentation.

Clean UK addresses on new Salesforce accounts

When

An account is created in Salesforce

Then

  1. Cleanse an address
  2. Update the account's address in Salesforce

With Salesforce

Validate emails and phone numbers of new HubSpot contacts

When

A contact is created in HubSpot

Then

  1. Validate an email address
  2. Validate a phone number
  3. Flag invalid details on the contact in HubSpot

With HubSpot

Check UK delivery addresses on Shopify orders

When

An order is placed in Shopify

Then

  1. Cleanse an address
  2. Add a note to the order in Shopify if the address fails

With Shopify

Apps you can build on Ideal Postcodes data

Internal tools your team can build with an AI assistant, each one using Ideal Postcodes calls from its API documentation.

Address entry helper

Lets call center staff enter a UK postcode and pick the full address from a list.

Customer contact cleanup tool

Cleans a customer's address and checks their email and phone before records are saved.

Lookup usage report

Shows API key usage stats and remaining lookups for the ops team.

Give your AI agents Ideal Postcodes tools

Build an MCP server on Ideal Postcodes in Agent Gateway and choose which actions your agents can call. Every call runs with access control and an audit trail. How Agent Gateway works

  • Look up a postcode
  • Find a place
  • Validate an email address
  • Check key availability
  • Find an address
  • Resolve an address
  • Cleanse an address
  • Retrieve an address by UDPRN

What the Ideal Postcodes API covers

4 resources and 13 documented actions, each one a call the HTTP Connector can make from a Tray.ai workflow. Connecting it takes a few clicks: here's how.

Addresses

  • Look up a postcode
  • Find an address
  • Resolve an address
  • Cleanse an address
  • Retrieve an address by UDPRN

Places

  • Find a place
  • Resolve a place

Validation

  • Validate an email address
  • Validate a phone number

API keys

  • Check key availability
  • Get key details
  • Get key usage stats
  • Download lookup logs

Checked against Ideal Postcodes's own documentation on 2026-10-22

docs.ideal-postcodes.co.uk/docs/api/api-reference

Frequently asked questions

What can a Tray.ai workflow do in Ideal Postcodes?

+

The Ideal Postcodes API documents 13 actions across 4 resources (Addresses, Places, Validation, API keys). For example: Look up a postcode; Find a place; Validate an email address. A workflow can make any documented call through the HTTP Connector.

How does Tray.ai authenticate with Ideal Postcodes?

+

The Ideal Postcodes API uses a bearer token and an API key in the query string. You save it once as a Tray.ai authentication, and the HTTP Connector adds it to every request.

See Ideal Postcodes working against your stack.

We'll walk through a tailored demo with your systems plugged in.

Great — a couple more details

This helps us connect you with the right person. Optional, and you can skip it.