Articles Export API

The Articles Export API allows you to securely export published articles from Poppulo for use in external applications.

You can integrate in one of two ways:

• Managed integration with Workato: Poppulo Technical Services configures and manages the integration using Workato recipes.
• Direct API integration: Authenticate using API credentials and connect directly to the Articles Export API.

Key capabilities

The Articles Export API provides secure, role-based access to published article content.

Export published articles

Retrieve published articles from Public folders for use in external systems.

Flexible integration options

Choose between a managed Workato integration and direct API access, depending on your organization's requirements.

Secure, role-based access

Access is controlled through API credentials and sub-account permissions managed in Integrations Manager.

Rich content export

Export article content in HTML format, including headings, subheadings, summaries, body content, and image URLs.

Filtering and localization

Filter articles by date range and time zone. Articles are returned in their original published language.

Getting started

Before using the Articles Export API, choose the integration approach that best fits your needs:

• Workato integration: Contact your Poppulo Customer Success Manager. Poppulo Technical Services will configure and manage the Workato integration on your behalf.
• Direct API integration: Follow the steps below to create an API client and authenticate with the Articles Export API.

Set up a direct API integration

Step 1: Navigate to the Developer Portal

1. Log in to your Poppulo account as a user with the Enterprise Integrations Manager or Enterprise Administrator role.
2. From the Dashboard, select Developer Portal.
3. Review the API documentation, authentication details, and endpoint reference.

Step 2: Create an API client

To authenticate your integration:

1. From the Dashboard, select Integrations Manager.
2. Select API Clients.
3. Select Create.
4. Enter a name and description for the API client.
5. Select the enterprise and sub-accounts that the client should be able to access.
6. Assign the required permissions:
   • Enterprise API Account Access for enterprise-level access.
   • API Content for the required sub-accounts.
7. Complete the setup and copy the generated Client ID and Client Secret.

Important: Store the Client ID and Client Secret securely. They will not be displayed again.

API structure and operations

The Articles Export API uses GraphQL and OAuth 2.0 client credentials for secure authentication.

A typical integration follows these steps:

1. Request an access token to authenticate the integration.
2. Retrieve the available enterprise and sub-account information.
3. Call the Articles Export API endpoint to retrieve published articles.
4. Receive the article content in JSON format.

Exported content

Exported article content can include:

• Heading
• Subheading
• Summary
• Article body in HTML format
• Images provided as temporary download URLs
• Content in the article's published language

Note: Image download URLs expire after one hour.

Learn more

For complete endpoint documentation, authentication details, and request examples, visit the Poppulo Developer Portal from your Poppulo Dashboard.