Public API Documentation

Warning: This Feature is currently in Beta and is in active-development. It does not provide all of the Postnify Features currently.

Getting Started

For NodeJS / N8N users

You can use the Postnify NodeJS SDK to interact with the Postnify Public API.

For a custom n8n node check Postnify n8n custom node

Authentication

Public API allows you to work with Postnify in headless mode. To use the Public API:

Go to Postnify settings and copy the API Key.
With each request you need to pass the API Key in the header Authorization: {apiKey}.

Base URLs:

Hosted version: https://api.postnify.com/public/v1

There is a limit of 30 requests per hour.

It does not mean you can post only 30 posts per hour, it means you can make 30 requests to the API per hour. If you plan ahead, you can have a lot more every hour.

NOTE: The UI representation is a channel, but on the API it is called integration. So when you see integration in the API, it means a channel.

API Endpoints

Get all added channels

GEThttps://api.postnify.com/public/v1/integrations

Response:

[
  {
    "id": "asdfasf2342dsaxfcsf",
    "name": "Nevo David",
    "identifier": "facebook",
    "picture": "https://upload.postnify.com/picture.png",
    "disabled": false,
    "profile": "nevo_david",
    "customer": {
      "id": "asdfasf2342dsaxfcsfsadfsadf",
      "name": "My Customer"
    }
  }
]

Upload a new file

POSThttps://api.postnify.com/public/v1/upload

Payload: file - File (form-data)

Response:

{
  "id": "e639003b-f727-4a1e-87bd-74a2c48ae41e",
  "name": "vXJYn8EzSB.png",
  "path": "https://uploads.postnify.com/vXJYn8EzSB.png",
  "organizationId": "85460a39-6329-4cf4-a252-187ce89a3480",
  "createdAt": "2024-12-14T08:18:54.274Z",
  "updatedAt": "2024-12-14T08:18:54.274Z"
}

Post list

GEThttps://api.postnify.com/public/v1/posts

Query Parameters:

Property	Type	Required	Description
startDate	string	Yes	UTC date in ISO format
endDate	string	Yes	UTC date in ISO format
customer	string	No	Customer ID

Response:

{
  "posts": [
    {
      "id": "cm4gklk8o00008copo77fa0f8",
      "content": "blabla",
      "publishDate": "2024-12-09T05:06:00.000Z",
      "releaseURL": "https://twitter.com/nevodavid/status/1865986385708204316",
      "state": "QUEUE|PUBLISHED|ERROR|DRAFT",
      "integration": {
        "id": "cm4ean69r0003w8w1cdomox9n",
        "providerIdentifier": "x",
        "name": "Nevo David",
        "picture": "https://uploads.postnify.com/5g9mEIVCAq.jpeg"
      }
    }
  ]
}

Last Updated

This documentation was last updated on August 4, 2025