Skip to content
Integrations

Custom API connection: publishing into any system

When to choose it, what to configure, how to test it, and what errors it reports.

Updated: 16 October 20263 min readStarter, Growth, Scale

Short answer

If you do not use WordPress, the custom API connection lets you publish into practically any system: you give the endpoint address, the authentication method, and which field Pagioo should put which content into. The connection is fully configurable, so it adapts to your target system's own field names rather than forcing your system into Pagioo's shape. A test send lets you verify the setup before any real content goes.

When to choose it

  • You use a headless CMS — for example a content store behind your own front end.
  • You have a bespoke website or an internal portal.
  • You want content to go into your own system first, and onwards from there.
  • You use WordPress but want publishing routed through an intermediate endpoint of your own.

What do you configure?

SettingWhat it isTypical value
EndpointThe address Pagioo sends content to.Your system's publishing endpoint
MethodThe kind of request.As your target system's documentation says
AuthenticationHow Pagioo identifies itself.A header token is the most common
Field mappingWhich part of the content goes into which field.title → title, body → content, image → image_url
Success conditionWhat Pagioo treats as a successful publish.Your system's success response

Verifying the setup

  1. Send a test

    You can trigger a test from the connection settings; it does not use real content.

  2. Read the response

    Pagioo shows the target system's answer. Authentication failures, missing required fields and invalid formats all surface here.

  3. Check in the target system

    A successful response does not guarantee the content landed in the right fields. Open the record that was created.

  4. Only then schedule real content

    A wrong field mapping can create a dozen half-empty records if several pieces go out at once.

What exactly does Pagioo send?

The article's title, body, image reference, metadata and taxonomy data — named according to your field mapping. The test response shows the exact payload.

What happens if the endpoint does not respond?

The publish goes to failed state with the error described, and the content stays in Pagioo. It can be retried after the fix.

Is this the same as the public API?

No. The custom API connection is outbound publishing: Pagioo sends into your system. The public API and webhooks are the opposite: your system queries Pagioo, and Pagioo notifies you of events. That one is on the Scale plan.

Looking for something else?

Search the whole knowledge base, or look at the other articles in Integrations.

Reading is good, trying it is better.

The Free plan starts with no card. Set up your brand and see it on your own topics.

Start freeBook a demo