An Post Guide

An Post offers domestic and international shipping solutions for shipments originating in Ireland. As the national postal service provider of Ireland, An Post is responsible for delivering mail and parcels across the country and operating post offices throughout its network.

This guide provides developers an overview of shipping services that An Post offers and the service codes that you will use to create An Post shipments.

Connect Your Account

ShipEngine API allows you to connect your An Post accounts programmatically without logging in to the ShipEngine API dashboard. This is useful if you have wrapped a custom UI around the ShipEngine API toolset and want to add or disconnect existing carrier accounts without exposing your end users to the API dashboard.

These APIs can be used in parallel with the ShipEngine Partner APIs to programmatically create new ShipEngine users, and then connect existing An Post accounts all via the API without logging into a dashboard. Together these APIs empower you to completely white-label the ShipEngine experience for your end users.

Continue below for instructions on how to programatically connect An Post using the ShipEngine API.

For instructions on connecting An Post via the ShipEngine dashboard, go to our An Post help article.

An Post Account Information Model

Property	Description	Type
`customer_account_number`	Account number	string_, required
`sftp_host`	SFTP Host	string, required
`sftp_username`	SFTP Username	string, required
`sftp_password`	SFTP Password	string, required
`sftp_location`	SFTP Location	string, required
`sequence_package_tracking_number_range_from`	Package tracking number range first number	number, required
`sequence_package_tracking_number_range_to`	Package tracking number range last number	number, required

Example POST Call

POST /v1/connections/carriers/An Post

1
2
3
4
5
6
7
8
9
10
11
12
POST /v1/connections/carriers/An Post HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "nickname": "My An Post Account"
  "account_number": "123456789",
  "company": "Example Corp.",
  "first_name": "John",
  "last_name": "Doe",
}

1
2
3
{
  "carrier-id": "se-1234567"
}

An Post Service Details

Service	Carrier Code	Service API Codes
Express With Signature Parcel	EXP	`an_post_express_with_signature_parcel`
Express With Signature Packet	SWP	`an_post_express_with_signature_packet`

Packages

Name	API Code	Package Attributes
Parcel	`an_post_parcel`	Domestic
Packet	`an_post_packet`	Domestic

Return Services

Return services are not supported for this carrier.

Adding Shipment Insurance

Adding shipment insurance is not supported for this carrier.

Additional Information

End of Day manifests are required for An Post. They are sent electronically to the SFTP location set up by merchants during connection.

You are now ready to create shipments using An Post via ShipEngine!