PagoPA Specifiche Integrazione Messaggi Di Cortesia (Server To Server) API

The Specifiche Integrazione Messaggi Di Cortesia (Server To Server) API from PagoPA — 2 operation(s) for specifiche integrazione messaggi di cortesia (server to server).

GitHub OpenAPI

Operations 2

POST /{auth_endpoint} Richiesta Token (OAuth2) #
POST /{message_endpoint} Ricezione Messaggio #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/pagopa:pagopa-specifiche-integrazione-messaggi-di-cortesia-server-to-server-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

pagopa-specifiche-integrazione-messaggi-di-cortesia-server-to-server-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Specifiche Integrazione Messaggi di Cortesia…
  version: 1.3.1
  description: '# Guida all''Integrazione


    Questo documento descrive le specifiche tecniche per l''integrazione con **Messaggi di Cortesia** (anche chiamato *EMD*).'
tags:
- name: Specifiche Integrazione Messaggi Di Cortesia (Server To Server)
paths:
  /{auth_endpoint}:
    post:
      summary: Richiesta Token (OAuth2)
      description: 'Endpoint dinamico per l''autenticazione.


        Per testare l''openapi inserire la parte finale del percorso nella variabile `auth_endpoint`, mentre il baseUrl impostarlo nella variabile `auth_base_url` nella sezione dedicata "Servers" dedicata sotto, dopo aver cliccato "Try it out".


        Il path completo della request sarà la concatenazione tra `auth_base_url` e `auth_endpoint`.'
      operationId: getToken
      servers:
      - url: '{auth_base_url}'
        description: Server Identity Provider
        variables:
          auth_base_url:
            default: https://login.microsoftonline.com/*tenantId*/oauth2/
            description: Base URL (Dominio)
      parameters:
      - in: path
        name: auth_endpoint
        required: true
        description: Percorso dell'endpoint (es. token). NON inserire lo slash iniziale.
        style: simple
        explode: false
        allowReserved: true
        schema:
          type: string
          example: token
      requestBody:
        description: Payload dinamico (Form Data).
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/AuthRequestDynamic'
      responses:
        '200':
          description: Autenticazione riuscita.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TokenResponse'
        '401':
          description: Credenziali non valide.
      tags:
      - Specifiche Integrazione Messaggi Di Cortesia (Server To Server)
  /{message_endpoint}:
    post:
      summary: Ricezione Messaggio
      description: 'Endpoint dedicato alla ricezione del Messaggio di Cortesia.


        Per testare l''openapi inserire la parte finale del percorso nella variabile `message_endpoint`, mentre il baseUrl impostarlo nella variabile `message_base_url` nella sezione dedicata "Servers" dedicata sotto, dopo aver cliccato "Try it out".


        Il path completo della request sarà la concatenazione tra `message_base_url` e `message_endpoint`.'
      operationId: receiveNotification
      security:
      - bearerAuth: []
      servers:
      - url: '{message_base_url}'
        description: Server Applicativo
        variables:
          message_base_url:
            default: https://api.tpp.it/api/v1/
            description: Base URL dell'api di ricezione messaggi.
      parameters:
      - in: path
        name: message_endpoint
        required: true
        description: Percorso del webhook (es. notifiche/ricevi). NON inserire lo slash iniziale.
        style: simple
        explode: false
        allowReserved: true
        schema:
          type: string
          example: message
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NotificationPayload'
      responses:
        '200':
          description: Notifica ricevuta. Il payload della risposta non viene considerato.
        '401':
          description: Token mancante.
      tags:
      - Specifiche Integrazione Messaggi Di Cortesia (Server To Server)
components:
  schemas:
    TokenResponse:
      type: object
      required:
      - access_token
      properties:
        access_token:
          type: string
        token_type:
          type: string
          example: Bearer
        expires_in:
          type: integer
          format: int64
    NotificationPayload:
      type: object
      required:
      - messageId
      - recipientId
      - title
      - triggerDateTime
      - triggerDateTimeUTC
      - senderDescription
      - messageUrl
      - originId
      - content
      - workflowType
      properties:
        messageId:
          description: ID univoco del messaggio.
          type: string
          minLength: 1
          maxLength: 100
          example: 8a32fa8a-5036-4b39-8f2e-47d3a6d23f9e
        recipientId:
          description: ID del destinatario (Codice Fiscale).
          type: string
          minLength: 1
          maxLength: 100
          example: RSSMRA85T10A562S
        triggerDateTime:
          description: Data e ora in cui il soggetto che ha originato il messaggio ha richiesto l'invio.
          type: string
          format: date-time
          example: '2024-06-21T12:34:56'
        triggerDateTimeUTC:
          type: string
          format: date-time
          description: Data e ora in cui il soggetto che ha originato il messaggio ha richiesto l'invio (ISO 8601).
          example: '2025-10-06T12:00:40.695Z'
        senderDescription:
          description: Descrizione del soggetto che ha originato il messaggio. Supporta UTF-8.
          type: string
          minLength: 1
          maxLength: 250
          example: Comune di Pontecagnano
        messageUrl:
          description: URL per recuperare il messaggio originale.
          type: string
          format: uri
          minLength: 1
          maxLength: 2048
          example: https://cittadini.dev.notifichedigitali.it
        originId:
          description: ID del messaggio originale.
          type: string
          minLength: 1
          maxLength: 100
          example: XRUZ-GZAJ-ZUEJ-202407-W-1
        title:
          description: Titolo del messaggio. Supporta UTF-8.
          type: string
          minLength: 1
          maxLength: 250
          example: Nuovo messaggio!
        content:
          description: 'Contenuto del messaggio in formato Markdown, dinamico in base a workflowType (ANALOG/DIGITAL).


            - ANALOG: include la scadenza per accedere alla notifica ed evitare la consegna postale

            - DIGITAL: messaggio standard senza scadenza, include informazioni sulla consegna legale

            '
          type: string
          minLength: 1
          maxLength: 100000
          example: Ciao, hai ricevuto una notifica SEND...
        associatedPayment:
          description: Flag che indica se è presente un pagamento associato.
          type: boolean
          example: true
        analogSchedulingDate:
          description: 'Data di scadenza per la deadline di 5 giorni (ISO 8601).

            Obbligatorio solo quando workflowType è ANALOG.

            '
          type: string
          format: date-time
          example: '2024-06-26T12:34:56.000Z'
        workflowType:
          description: Identifica il tipo di notifica (ANALOG o DIGITAL).
          type: string
          enum:
          - ANALOG
          - DIGITAL
          example: ANALOG
      example:
        messageId: 8a32fa8a-5036-4b39-8f2e-47d3a6d23f9e
        recipientId: RSSMRA85T10A562S
        triggerDateTime: '2024-06-21T12:34:56'
        triggerDateTimeUTC: '2024-06-21T12:34:56.000Z'
        senderDescription: Comune di Pontecagnano
        messageUrl: https://cittadini.dev.notifichedigitali.it
        originId: XRUZ-GZAJ-ZUEJ-202407-W-1
        title: Nuovo messaggio!
        content: Ciao, hai ricevuto una notifica SEND...
        analogSchedulingDate: '2024-06-26T12:34:56.000Z'
        workflowType: ANALOG
        associatedPayment: true
    AuthRequestDynamic:
      type: object
      description: Credenziali dinamiche.
      additionalProperties:
        type: string
      example:
        client_id: CLIENT_123
        client_secret: SECRET_XYZ
        grant_type: client_credentials
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT