Shopware icon

Shopware

Shopware

Actions778

Newsletter Recipient → Get Newsletter Recipient List

AI-generated

Overview

This node operation retrieves a list of newsletter recipients from the Shopware platform. It is useful for scenarios where you need to fetch and manage newsletter subscriber data, such as for marketing campaigns, data analysis, or synchronization with other systems. For example, you can use it to get a paginated list of recipients with optional filtering using a SwagQL query.

Use Case Examples

  1. Fetch the first 50 newsletter recipients to display in a dashboard.
  2. Retrieve a specific page of newsletter recipients for batch processing.
  3. Use a SwagQL query to filter recipients based on subscription status or other criteria.

Properties

Name Meaning
Limit Maximum number of newsletter recipient resources to be returned in a single page.
Page The page number of the newsletter recipient list to be returned.
Query Encoded SwagQL query in JSON format to filter or customize the list of newsletter recipients.
Request Options Additional request settings such as batching, SSL certificate validation, proxy configuration, and request timeout.

Output

JSON

  • recipients - Array of newsletter recipient objects returned from the API.
  • total - Total number of newsletter recipients available matching the query.
  • page - Current page number of the returned list.
  • limit - Maximum number of recipients returned per page.

Dependencies

  • Shopware platform API
  • An API key credential for authentication

Troubleshooting

  • Ensure the API credentials are correctly configured and have the necessary permissions to access newsletter recipient data.
  • Check that the 'limit' and 'page' parameters are set to valid numbers to avoid request errors.
  • If using a custom SwagQL query, verify the query syntax and encoding to prevent API errors.
  • If SSL issues occur, consider enabling the 'Ignore SSL Issues' option, but be aware of security risks.
  • Network issues or proxy misconfiguration can cause request failures; verify proxy settings if used.

Discussion