All your mailings via API and in real time
Automate the sending of documents, registered mail, telegrams, advertisements with Post Office.
For sending telegrams via API the reference endpoint is POST /telegrammi/.
In the body of the request, the data on the:
- sender (first name, last name, full address)
- recipient(s) (first name, last name, full address)
- document
- possible additional option (delivery notice)
The reply provides the details of the requested telegram, in particular
- sender (first name, last name, full address)
- addressee(s) (first name, last name, full address)
- document specifications
- final price
- telegram id
PLEASE NOTE: The id will be useful later for obtaining information on the telegram sent.
It is also possible to save the telegram for later sending via the "autoconfirm" parameter, which in this case should be set to "false". To confirm the sending at a later time, you will need to use the PATCH endpoint /telegrammi/{id} by passing the sending id and in the body of the request the value "confirmed":true
For sending registered letters via API, the reference endpoint is POST /raccomandate/.
In the body of the request, the data on the:
- sender (first name, last name, full address)
- addressee(s) (first name, last name, full address)
- document
- possible additional option (front/back, colours, return, delivery notice)
The reply provides the details of the registered mail requested, in particular
- sender (name, surname, full address)
- addressee(s) (name, surname, full address)
- document specifications
- final price
- registered mail id
PLEASE NOTE: The id will be useful later on to obtain information on the registered mail sent and for tracking purposes.
It is also possible to save the registered letter for later sending via the "autoconfirm" parameter which, in this case, must be set to false. To confirm the sending at a later date, it will be necessary to use the PATCH endpoint /raccomandate/{id} by passing the id of the dispatch and in the body of the request the value "confirmed":true
For sending ordinary mail via API the reference endpoint is POST /ordinarie/.
In the body of the request you must specify data on:
- sender (first name, last name, full address)
- recipient(s) (first name, last name, full address)
- document
- possible additional option (front/back, colours, delivery notice)
The reply provides details on:
- sender (first name, last name, full address)
- addressee(s) (first name, last name, full address)
- document specifications
- final price
- ordinary mail id
PLEASE NOTE: The id will be useful later on to obtain information on the item sent.
It is also possible to save the ordinary mail for later dispatch via the "autoconfirm" parameter which, in this case, must be set to false. To confirm the dispatch at a later date, you will need to use the PATCH endpoint /ordinarie/{id} by passing the id of the dispatch and in the body of the request the value "confirmed":true
For sending registered mails via API the reference endpoint is POST /prioritarie/.
In the body of the request, data on the:
- sender (first name, last name, full address)
- addressee(s) (first name, last name, full address)
- document
- possible additional option (front/back, colours, delivery notice)
The reply provides details on:
- sender (first name, last name, full address)
- addressee(s) (first name, last name, full address)
- document specifications
- final price
- priority mail id
PLEASE NOTE: The id will be useful later for obtaining information on the item sent and for tracking purposes.
It is also possible to save the Priority Mail item for a later dispatch via the "autoconfirm" parameter which, in this case, must be set to false. To confirm the sending at a later date, you will need to use the PATCH /prioritarie/{id} enpoint by passing the id of the mailing and in the body of the request the value "confirmed":true
To send telegrams via API, the relevant endpoint is POST /telegrammi/. In the request body, you need to specify the following information:
- Sender (name, surname, full address)
- Recipient(s) (name, surname, full address)
- Message (which includes the sender's information)
- Additional options (Delivery receipt, Scheduled sending)
The response will provide the details of the requested telegram, including:
- Sender (name, surname, full address)
- Recipient(s) (name, surname, full address)
- Message sent
- Final price
- Telegram ID
Note: The ID will be useful later to get information about the sent telegram.
You can also save the telegram for later sending by setting the "autoconfirm" parameter to false. To confirm the sending at a later time, use the PATCH /telegrammi/{id} endpoint, passing the shipment ID and setting the "confirmed" value to true in the request body.
To send priority mail via API, the relevant endpoint is POST /prioritarie/. In the request body, the following details must be specified:
- Sender (name, surname, full address)
- Recipient(s) (name, surname, full address)
- Document content or attachment (URL, HTML, plain text)
- Additional options (Delivery receipt, Duplex, Color, Scheduled sending)
The response provides details on:
- Sender (name, surname, full address)
- Recipient(s) (name, surname, full address)
- Document specifications
- Final price
- Postapriority ID
Note: The ID will be useful later for obtaining information on the sent item and for tracking.
You can also save the priority mail for later sending by setting the "autoconfirm" parameter to false. To confirm the sending at a later time, use the PATCH /prioritarie/{id} endpoint, passing the shipment ID and setting the "confirmed" value to true in the request body.
To send ordinary mail via API, the relevant endpoint is POST /ordinarie/. In the request body, the following details must be specified:
- Sender (name, surname, full address)
- Recipient(s) (name, surname, full address)
- Document content or attachment (URL, HTML, plain text)
- Additional options (Delivery receipt, Duplex, Color, Scheduled sending)
The response provides details on:
- Sender (name, surname, full address)
- Recipient(s) (name, surname, full address)
- Document specifications
- Final price
- Postamail ID
Note: The ID will be useful later for obtaining information on the sent item.
You can also save the ordinary mail for later sending by setting the "autoconfirm" parameter to false. To confirm the sending at a later time, use the PATCH /ordinarie/{id} endpoint, passing the shipment ID and setting the "confirmed" value to true in the request body.
For sending registered mail smart via API, the reference endpoint is POST /raccomandate_smart/.
In the body of the request, the data on the:
- sender (first name, last name, full address)
- addressee(s) (first name, last name, full address)
- document
- possible additional options (front/back, colours, return, delivery notice, possible callback URL)
The reply provides the details of the requested registered smart mail, in particular
- sender (first name, last name, full address)
- addressee(s) (first name, last name, full address)
- document specifications
- final price
- registered mail smart id
PLEASE NOTE: The id will be useful later for obtaining information on the registered smart mail sent and for tracking.
You can also save the registered smart mail for later sending via the "autoconfirm" parameter which, in this case, must be set to false. In order to confirm the sending at a later date, it will be necessary to use the PATCH endpoint /raccomandate_smart/{id} by passing the id of the sending and in the body of the request the value "confirmed":true
For sending massive mail via API the reference endpoint is POST /posta_massiva/.
In the body of the request the data on the:
- sender (first name, last name, full address)
- recipient(s) (first name, last name, full address)
- document
- possible additional option (front/back, colours, delivery notice)
The reply provides details on:
- sender (first name, last name, full address)
- addressee(s) (first name, last name, full address)
- document specifications
- final price
- massive mail id
PLEASE NOTE: The id will be useful later for obtaining information about the mailing.
It is also possible to save the massive mail for later dispatch via the "autoconfirm" parameter which, in this case, must be set to false. To confirm the sending at a later date, you will need to use the PATCH /posta_massiva/{id} endpoint by passing the id of the mailing and in the body of the request the value "confirmed":true
Yes, the cover page of the communication can be fully customized, allowing you to add your company logo, information, or promotions, for example.
Customization can be done via API using the dedicated endpoint or through the Playground, which also provides a preview before sending.
Cover Page customization is available for:
- Online Registered Mail
- International Registered Mail
- Posta 1 (Priority Mail)
- Posta 4 (Standard Mail)
- Postapriority
- Postamail
Digital storage is a free service enabled by default, allowing access to the sent content, signed and digitally stamped by Poste Italiane. This service certifies the content sent with legal validity and makes it available for 12 months.
The service is available for the following postal products:
- Online Registered Mail
- International Registered Mail
- Posta 1
- Posta 4
- Postapriority
- Postamail
It is possible to include more than one recipient only for italian Postal services such as telegrams, registered mail, priority mail, ordinary mail, smart registered mail, and mass mailing. For international sendings, however, only one recipient can be included.
Yes, the list is available via the GET method.
Depending on the service, the reference endpoint will be:
- GET /telegrammi/ for telegrams (both Italian and international)
- GET /raccomandate/ for registered letters (both Italian and international)
- GET /prioritarie/ for priority mail (both Italian and international)
- GET /ordinarie/ for ordinary mail (both Italian and international)
- GET /raccomandate_smart/ for registered mail smart
- GET /posta_massiva/ for bulk mail
No start parameter is required.
Yes, it is possible to check previous mailings via the endpoints:
- GET /telegrammi/{id} for telegrams (both Italian and international)
- GET /raccomandate/{id} for registered letters (both Italian and international)
- GET /prioritarie/{id} for priority mail (both Italian and international)
- GET /ordinarie/{id} for ordinary mail (both Italian and international)
- GET /raccomandate_smart/{id} for smart registered mail
- GET /posta_massiva/{id} for bulk mail
In all cases, the id, which is obtained when sending the product, is required as a starting parameter.
Other parameters (if set) are optional:
- receipt (for telegrams, registered, priority and ordinary mail): a PDF is returned in the reply
- status (for all services)
- callback (ONLY for the sandbox environment and only for registered mail)
It is possible to track shipments of certain products to Italy, but only for those that include the tracking service, i.e. registered mail, priority mail and registered smart mail.
The reference endpoint is GET /tracking/{id} and the starting parameter is the id.
There is no tracking for products sent abroad.
The "sender" option allows you to enter the sender's data directly into the telegram text.
For shipments to Italy, this option must be selected for the data to be visible.
For international shipments, however, the entry of the sender is done automatically.
It is important to note that the words used for the sender will be included in the overall telegram count.
The time it takes for Poste Italiane to take charge of the request varies according to the service requested:
Registered Mail: in real time
Telegram: in real time
Ordinary Mail: in real time
Priority Mail: in real time
Massive Mail: in seconds
Registered Mail Smart: in seconds
The average delivery time varies depending on the service requested:
- Registered mail: 4-6 working days
- Telegram: from 24 hours
- Ordinary Mail: from 4 days
- Priority Mail: from 24 hours
- Massive Mail: from 7-9 days
- Registered mail Smart: from 4-7 days
International telegrams are entrusted to the national postal operator on the same day, while delivery to the addressee will take place according to the local postal system's time schedule.
Delivery times vary depending on the country of destination.
Delivery times for International Postapriority depend on the destination country and are as follows:
- Europe: 3 working days (excluding Saturdays and public holidays) after the day of mailing for 85% of items
- Mediterranean region: 4/5 working days (excluding Saturdays and public holidays) after the day of mailing, in 85% of consignments
- Countries of North America: 5/6 working days (excluding Saturdays and public holidays) after the mailing day, in 85% of consignments
- Countries of the rest of the Americas, Asia and Oceania: 7/8 working days (excl. Saturdays and public holidays) plus dispatch day, in 85% of consignments
- Other countries in Africa: 8/9 working days (excl. Saturdays and public holidays) plus dispatch day, in 85% of consignments
In the case of online shipments, the following processing times are added to the stated delivery times: print in one working day (T+1), if the shipment is accepted by 2 p.m. from Monday to Friday, excluding public holidays.
The delivery times for International Postamail shipments are as follows:
- Europe: delivery in 85% of cases in 8 working days (excluding Saturdays and public holidays) after the day of mailing
- Mediterranean basin: delivery in 85% of cases in 12 working days (excluding Saturdays and holidays) after the day of dispatch
- North America and Oceania: delivery in 85% of cases within 16 working days (excluding Saturdays and holidays) after the shipping day
- Rest of the world: delivery in 85% of cases in 22 working days (excluding Saturdays and holidays) after the shipping day
In the case of online shipments, the following processing times are added to the stated delivery times: print in one working day (T+1), if the shipment is accepted by 14:00 from Monday to Friday, excluding public holidays.
The cost of a single request varies depending on the endpoint and is as low as 0,32€.
- For Registered Mail: the cost starts from €4.24.
- For Telegrams: the cost starts from €3.63.
- For Ordinary Mail (Posta 4): the cost starts from €1.03.
- For Priority Mail (Posta 1): the cost starts from €2.28.
- For Mass Mailing: the cost starts from €0.32.
- For Smart Registered Mail: the cost starts from €2.60.
- For International Telegrams: the cost starts from €1.90.
- For International Registered Mail: the cost starts from €7.50.
- For International Postamail: the cost starts from €1.30.
- For International Postapriority: the cost starts from €3.60.
All prices are available in the "Pricing" section.
You can also obtain price details via the GET /pricing/ endpoint.
In the Usage section, at the API level, you can monitor your free and top-up requests. They are available both in graphical mode (period month and year) and with a textual summary.