Skip to content
Create free account

Help

API and webhooks

Connect a custom-built website with Liva’s API or signed webhooks, and see when the connection counts.

What can the API do?

The API is for websites and systems that Liva has no ready-made connection to. Your integration fetches the approved articles, publishes them on your platform and tells Liva the public address.

  • Fetch approved articles, images and included network links.
  • Receive a signed event when a new article is approved.
  • Confirm the public address. Liva checks the page before the article is marked as published.

Create an API key

  1. Open Settings → Publishing → For developers for the website.
  2. Click Create API key.
  3. Save this secret now. It is shown only once.
  4. Put the key on your server, never in code that runs in the browser.

A key applies to one website. With Rotate API key or Revoke API key, the old key stops working immediately. Only the website owner and admins can manage integrations.

Set up a webhook

  1. Enter your endpoint’s address under Webhook URL. It must be public and use HTTPS.
  2. Click Save webhook and store the signing secret. It is shown only once.
  3. Click Send test and check the result under Delivery history.

Webhooks are only sent for future approvals. Previously approved articles are fetched with the API. Failed deliveries are retried automatically, and you can retry them yourself from the delivery history.

When is the website connected via API?

The website only counts as connected via API once your API key has been used at least once, or once a webhook has been delivered at least once. Creating a key or saving a webhook is not enough.

Good to know

A test delivery also counts. Use Send test to confirm your webhook right away.

Liva checks and approves new daily articles automatically at the saved publishing time. Your API integration publishes them.

Connect a CMS only if Liva should publish directly instead of your API integration.

From approved to published

  1. Fetch the article and claim it before you publish. Then it cannot be changed in the meantime.
  2. Publish the article on your website with its title, full text, sources and image.
  3. Send the public address to Liva. Liva opens the page and marks the article as published when the content matches.

Good to know

A delivered webhook is not a published article. Liva verifies the public URL before recording publication.

The technical documentation with examples, signatures and limits is available in English.

Didn’t find the answer?

Write to us and we’ll help you further.

team@liva.so