INTEGRATING WITH DOCMAIL

We know that some companies might want to integrate with our system, which is why we offer just that.

The API (application programme interface) allows you to send A4 letters, postcards and greeting cards from a click of a button within your own computer systems.

Docmail perfectly blends both physical and electronic communications. Once the integration is in place, Docmail receives the electronic document and mailing list from you, and perfectly outputs the documents into your physical mail. Which we then securely pass to Royal Mail for delivery.

It's secure, it's simple, it's perfect for developers.

WHAT YOU NEED TO KNOW

Integration offering

Seamless integration for your communication requirements, supporting you in your business goals and the saving of time and resource.

The test environment

Run your personalised test mailings, to ensure we get it right and help you deliver meaningful connections.

Docmail API 2.0 help guide

Download the full web service help guide to learn how to integrate your application with Docmail. The guide can be accessed here.

Docmail API access questionnaire

To be considered for an API integration, please complete our questionnaire and return to customersupport@cfh.com. The questionnaire can be downloaded here.

Get in touch

If you want to find out more about our Docmail API get in touch, we’ll be happy to discuss your requirements.

Docmail fair usage policy

Please read our fair usage policy which defines 'best practice' for integrating with our API. This policy can be accessed here.

THE DOCMAIL API

The API is a SOAP-based webservice allowing the creation, proofing and confirmation of orders for mailings, single letters, postcards and greeting cards.

Documents (PDF, RTF or Word files) are submitted as files or selected by name from your account. Address lists may be selected by name, submitted as a file (CSV, XLS, XLSX, Tab delimited, fixed length fields etc.) or added as individual addresses using the AddAddress call.

A PDF proof approval is available, but is no longer a required step in the process.

Payment is made via Top-Up credit on the customer Account, or for large volume users, payment on invoice may be available (subject to status, volume and regularity of orders).

The API documentation includes an example for creating a mailing with a Visual Studio console application using C# .NET 6.

Examples in the API documentation are based around Microsoft Visual Basic .NET code.

SECURE TEST MAILINGS

Docmail provides test mailings for use when integrating the API. You use the same API, and web functionality as a real mailing. We do not produce any print or mail output from test mailings and no credit is required to submit test mailings. You can also simulate failure scenarios, such as insufficient credit, when attempting to submit test mailings through the API.