Skip to content
Developer Tools

Integrate Postal Mail Into Your Applications

Automate your mail processes with our powerful API. Send letters, postcards, and documents programmatically with just a few lines of code.

// Sample API integration using Node.js
const axios = require('axios');

async function sendLetter() {
  try {
    const response = await axios.post(
      'https://api.intelliprint.net/v1/prints',
      {
        document: 'base64_encoded_file',
        recipients: [{
          name: 'John Smith',
          address: {
            line1: '123 Main St',
            city: 'London',
            postcode: 'SW1A 1AA'
          }
        }],
        options: {
          color: 'full',
          duplex: true
        }
      },
      {
        headers: {
          'Authorization': 'Bearer YOUR_API_KEY',
          'Content-Type': 'application/json'
        }
      }
    );
    
    console.log('Letter sent successfully:', response.data);
    return response.data;
  } catch (error) {
    console.error('Error sending letter:', error.response?.data || error.message);
    throw error;
  }
}
Node.js Example

API Features

Our RESTful API provides everything you need to integrate mail processing into your applications

Document Handling

Upload, process, and send documents programmatically. Convert various formats, merge files, and apply templates.

Security First

End-to-end encryption, authentication tokens, and secure webhooks ensure your data remains protected.

Scalable Processing

Send from one to thousands of documents with batch processing, template application, and bulk operations.

Powerful Integration

Connect your CRM, ERP, or custom systems through our RESTful API. Webhooks for real-time updates.

Analytics & Reporting

Track deliveries, view detailed analytics, and access comprehensive reporting through API endpoints.

Test Environment

Develop and test your integration in our sandbox environment before going live.

How to Integrate

Follow these simple steps to integrate our API into your applications

01

Register for API Access

Create an account and request API credentials from your dashboard.

Sign Up
02

Obtain Authentication

Generate your API key and secret for secure authentication.

Auth Guide
03

Test in Sandbox

Use our test environment to validate your integration without sending real mail.

Sandbox Info
04

Go Live

Switch to production mode when you're ready to start processing real mail.

Production Guide

API Best Practices

Optimise your integration with these recommended patterns and techniques

Implement Proper Error Handling

Design your integration to gracefully handle API errors and have fallback procedures in place.

Use Webhooks for Status Updates

Instead of polling our API, implement webhooks to receive real-time updates about your mail.

Batch Similar Documents

Group similar letters and documents together for more efficient processing and cost savings.

Implement Retries with Backoff

Use exponential backoff for retries to handle temporary service disruptions gracefully.

Validate Addresses Client-Side

Implement basic address validation before sending to reduce errors and reprocessing.

Securely Store Credentials

Never hardcode API keys in your application. Use environment variables or secure vaults.

Rate Limits & Fair Usage

Our API enforces rate limits to ensure consistent performance for all users. Basic accounts can make up to 60 requests per minute. Enterprise plans have higher limits. Implement proper backoff and retry mechanisms to handle rate limit errors.

Learn more about rate limits

Support & Resources

Everything you need to successfully integrate with our API

Documentation

Comprehensive API reference, guides, and examples to help you integrate quickly.

Code Samples

Ready-to-use code samples in multiple languages including JavaScript, PHP, Python, and more.

Developer Support

Get technical assistance from our developer support team for your API integration.

Ready to Integrate?

Start sending mail programmatically today. Sign up for an account, grab your API keys, and begin automating your mail processes.