API & Webhooks

Create and schedule posts from n8n, Make, Zapier or your own code, and get notified when posts publish or fail.

Updated November 14, 2026

API and Webhooks getting started

What It Does

The Postigniter API lets your own tools create, schedule and publish posts to your connected Facebook, Instagram and YouTube accounts. It works with n8n, Make, Zapier or custom code. Webhooks let those tools know the moment a post is published or fails.

Open it from ⋮ → API & Webhooks on the dashboard, or Settings → API & Webhooks.

Who can use it: API publishing and webhooks are available on paid plans to the workspace owner and Co-owners.

Getting Started

The Getting started panel has everything prefilled for your workspace:

  • your Base URL and Workspace UUID, each with a copy button
  • ready-to-paste examples for cURL, n8n and Make
  • the list of available endpoints and the permission each one needs

Follow the three steps:

  1. Connect accounts — make sure Facebook, Instagram or YouTube is connected.
  2. Create a token — tick content:write, content:publish and media:write.
  3. Send your first post — use one of the examples, replacing YOUR_TOKEN with your token.

Creating a Token

  1. Under Create a new token, give it a name, for example Zapier — TrueLiberia.
  2. Tick the permissions it needs:
    • content:read — read connected accounts and posts
    • content:write — create, edit and delete drafts
    • content:publish — schedule and publish posts
    • media:write — upload images and videos
    • webhooks:manage — manage webhooks
  3. Click Create token and copy it straight away. It's only shown once.

Tip: leave content:publish unticked to make a drafts-only token. Posts then wait in Postigniter for you to review and schedule.

Revoke a token at any time from Tokens for this workspace.

Scheduling Options

When you create a post through the API, choose:

  • now — publish immediately
  • at — publish at a specific time
  • next_slot — your next recommended posting time
  • draft — save as a draft

Webhooks

  1. Under Webhooks, paste the URL of your n8n Webhook trigger or Make Custom webhook. It must be HTTPS.
  2. Choose the events: post.published and/or post.failed. Leave Only posts created via the API ticked, or untick it to hear about every post.
  3. Click Add webhook and copy the signing secret. Every request is signed with a Postigniter-Signature header so you can verify it came from us.

Use Send test to check your endpoint. If an endpoint keeps failing, the webhook is disabled automatically; re-enable it once it's fixed. You can have up to five webhooks per workspace.

Full Documentation

Click View API documentation for the complete reference, including request and response examples and the OpenAPI spec you can import into n8n or Postman.

Tips for Best Results

  • Send an Idempotency-Key header when creating posts so a retried request never creates a duplicate.
  • Use next_slot to let Postigniter space your automated posts at the best times.
  • Create one token per tool. That way you can revoke one integration without breaking the others.