Palo Alto Networks Email Destinations API

Email forwarding destination management.

Operations 2

GET /log-forwarding-profiles/{profile_id}/destinations/email Palo Alto Networks List Email Destinations #
POST /log-forwarding-profiles/{profile_id}/destinations/email Palo Alto Networks Create Email Destination #

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/palo-alto-networks-email-destinations-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

palo-alto-networks-email-destinations-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Palo Alto Networks Email Destinations API
  version: '1.0'
  contact:
    name: Palo Alto Networks Developer Support
    url: https://pan.dev/
  license:
    name: Proprietary
    url: https://www.paloaltonetworks.com/legal
  description: 'Operations tagged Email Destinations across 2 of this provider''s published API definitions: palo-alto-networks-email-destinations-api-openapi.yml, palo-alto-strata-logging-service-api-openapi-original.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.stratacloud.paloaltonetworks.com/aiops/bpa/v1
  description: AIOps for NGFW BPA API production server.
- url: https://api.sase.paloaltonetworks.com/logging-service/v1
  description: Strata Logging Service API production server.
security:
- oauth2Bearer: []
tags:
- name: Email Destinations
  description: Email forwarding destination management.
paths:
  /log-forwarding-profiles/{profile_id}/destinations/email:
    get:
      operationId: listEmailDestinations
      summary: Palo Alto Networks List Email Destinations
      description: Returns the email destinations configured for a log forwarding profile.
      tags:
      - Email Destinations
      parameters:
      - name: profile_id
        in: path
        required: true
        description: Unique identifier of the log forwarding profile.
        schema:
          type: string
        example: '684382'
      responses:
        '200':
          description: Email destinations returned.
          content:
            application/json:
              schema:
                type: object
                properties:
                  total:
                    type: integer
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/EmailDestination'
              examples:
                ListEmailDestinations200Example:
                  summary: Default listEmailDestinations 200 response
                  x-microcks-default: true
                  value:
                    total: 692
                    items:
                    - destination_id: '123266'
                      name: Production Sensor 97
                      gateway: example-gateway
                      from: security-ops@example.com
                      to: security-ops@example.com
                      and_also_to: soc-admin@example.com
                      enabled: true
                      created_at: '2026-02-21T20:59:59Z'
                    - destination_id: '123266'
                      name: Production Sensor 97
                      gateway: example-gateway
                      from: security-ops@example.com
                      to: security-ops@example.com
                      and_also_to: soc-admin@example.com
                      enabled: true
                      created_at: '2026-02-21T20:59:59Z'
        '401':
          description: Invalid or missing Bearer token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                ListEmailDestinations401Example:
                  summary: Default listEmailDestinations 401 response
                  x-microcks-default: true
                  value:
                    error: example-error
                    message: Monitoring investigation network on activity investigation blocked malware alert activity rule activity.
                    request_id: 59fcc104-7100-494b-b0c4-09f9dcc477d9
        '403':
          description: Insufficient permissions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                ListEmailDestinations403Example:
                  summary: Default listEmailDestinations 403 response
                  x-microcks-default: true
                  value:
                    error: example-error
                    message: Monitoring investigation network on activity investigation blocked malware alert activity rule activity.
                    request_id: 59fcc104-7100-494b-b0c4-09f9dcc477d9
        '404':
          description: Log forwarding profile not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                ListEmailDestinations404Example:
                  summary: Default listEmailDestinations 404 response
                  x-microcks-default: true
                  value:
                    error: example-error
                    message: Monitoring investigation network on activity investigation blocked malware alert activity rule activity.
                    request_id: 59fcc104-7100-494b-b0c4-09f9dcc477d9
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                ListEmailDestinations500Example:
                  summary: Default listEmailDestinations 500 response
                  x-microcks-default: true
                  value:
                    error: example-error
                    message: Monitoring investigation network on activity investigation blocked malware alert activity rule activity.
                    request_id: 59fcc104-7100-494b-b0c4-09f9dcc477d9
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      operationId: createEmailDestination
      summary: Palo Alto Networks Create Email Destination
      description: Adds an email destination to a log forwarding profile.
      tags:
      - Email Destinations
      parameters:
      - name: profile_id
        in: path
        required: true
        description: Unique identifier of the log forwarding profile.
        schema:
          type: string
        example: '708543'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EmailDestinationRequest'
            examples:
              CreateEmailDestinationRequestExample:
                summary: Default createEmailDestination request
                x-microcks-default: true
                value:
                  name: Production Firewall 78
                  gateway: example-gateway
                  from: jsmith@example.com
                  to: jane.doe@example.com
                  and_also_to: soc-admin@example.com
                  enabled: true
      responses:
        '201':
          description: Email destination created successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmailDestination'
              examples:
                CreateEmailDestination201Example:
                  summary: Default createEmailDestination 201 response
                  x-microcks-default: true
                  value:
                    destination_id: '123266'
                    name: Production Sensor 97
                    gateway: example-gateway
                    from: security-ops@example.com
                    to: security-ops@example.com
                    and_also_to: soc-admin@example.com
                    enabled: true
                    created_at: '2026-02-21T20:59:59Z'
        '400':
          description: Invalid request body.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                CreateEmailDestination400Example:
                  summary: Default createEmailDestination 400 response
                  x-microcks-default: true
                  value:
                    error: example-error
                    message: Monitoring investigation network on activity investigation blocked malware alert activity rule activity.
                    request_id: 59fcc104-7100-494b-b0c4-09f9dcc477d9
        '401':
          description: Invalid or missing Bearer token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                CreateEmailDestination401Example:
                  summary: Default createEmailDestination 401 response
                  x-microcks-default: true
                  value:
                    error: example-error
                    message: Monitoring investigation network on activity investigation blocked malware alert activity rule activity.
                    request_id: 59fcc104-7100-494b-b0c4-09f9dcc477d9
        '403':
          description: Insufficient permissions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                CreateEmailDestination403Example:
                  summary: Default createEmailDestination 403 response
                  x-microcks-default: true
                  value:
                    error: example-error
                    message: Monitoring investigation network on activity investigation blocked malware alert activity rule activity.
                    request_id: 59fcc104-7100-494b-b0c4-09f9dcc477d9
        '404':
          description: Log forwarding profile not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                CreateEmailDestination404Example:
                  summary: Default createEmailDestination 404 response
                  x-microcks-default: true
                  value:
                    error: example-error
                    message: Monitoring investigation network on activity investigation blocked malware alert activity rule activity.
                    request_id: 59fcc104-7100-494b-b0c4-09f9dcc477d9
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                CreateEmailDestination500Example:
                  summary: Default createEmailDestination 500 response
                  x-microcks-default: true
                  value:
                    error: example-error
                    message: Monitoring investigation network on activity investigation blocked malware alert activity rule activity.
                    request_id: 59fcc104-7100-494b-b0c4-09f9dcc477d9
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    servers:
    - url: https://api.stratacloud.paloaltonetworks.com/aiops/bpa/v1
      description: AIOps for NGFW BPA API production server.
components:
  schemas:
    EmailDestination:
      type: object
      properties:
        destination_id:
          type: string
          description: Unique identifier of the email destination.
          example: '123266'
        name:
          type: string
          description: Display name of the destination.
          example: Production Sensor 97
        gateway:
          type: string
          description: SMTP server hostname.
          example: example-gateway
        from:
          type: string
          format: email
          description: Sender email address.
          example: security-ops@example.com
        to:
          type: string
          format: email
          description: Recipient email address.
          example: security-ops@example.com
        and_also_to:
          type: string
          format: email
          description: Additional recipient email address.
          example: soc-admin@example.com
        enabled:
          type: boolean
          example: true
        created_at:
          type: string
          format: date-time
          example: '2026-02-21T20:59:59Z'
    EmailDestinationRequest:
      type: object
      required:
      - name
      - gateway
      - from
      - to
      properties:
        name:
          type: string
          description: Display name for this email destination.
          example: Production Firewall 78
        gateway:
          type: string
          description: SMTP server hostname or IP address.
          example: example-gateway
        from:
          type: string
          format: email
          description: Sender email address.
          example: jsmith@example.com
        to:
          type: string
          format: email
          description: Primary recipient email address.
          example: jane.doe@example.com
        and_also_to:
          type: string
          format: email
          description: Additional recipient email address.
          example: soc-admin@example.com
        enabled:
          type: boolean
          default: true
          example: true
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Error code identifying the error type.
          example: example-error
        message:
          type: string
          description: Human-readable description of the error.
          example: Monitoring investigation network on activity investigation blocked malware alert activity rule activity.
        request_id:
          type: string
          description: Request identifier for support correlation.
          example: 59fcc104-7100-494b-b0c4-09f9dcc477d9
  securitySchemes:
    oauth2Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: OAuth 2.0 Bearer token for SASE platform authentication. Obtain using the client_credentials grant with your SASE service account client ID and client secret.
x-refined-from:
- palo-alto-networks-email-destinations-api-openapi.yml
- palo-alto-strata-logging-service-api-openapi-original.yml