Information about the API

Beneath you will find information about the API v1 — version 3.1.17, released on 21st May 2026

Upload and manage images and videos

Users can now upload media files directly via the API and organize them into their own collections. This opens up workflows such as:

An image processing system that automatically sends new product images to the correct collection in PinToMind as soon as they are approved
An HR solution that uploads employee photos and keeps them updated without manual work
An event platform that publishes program images and logos to relevant screens ahead of events

PDF files are automatically unpacked into individual pages, so that a presentation or multi-page document can be displayed page by page without extra work.

Create and publish posts

All post types can now be created, edited, and deleted via the API. Posting and publishing are two separate steps — you can prepare content well in advance and choose exactly when and where it is published.

Examples:

A crisis communication system that automatically sends important messages to all screens in a building as soon as an alarm is triggered
An online store that updates price displays based on inventory data, without anyone needing to log in manually
An event system that publishes session information to the correct screen in the correct meeting room, based on booking data
A cafeteria app that updates the daily menu post every morning from its own system

Scheduling from your own system

Posts can now be given detailed schedules via the API — weekly repetitions, specific date periods, and what should happen when the schedule expires (archive, unpublish, or delete).

Themes, color palettes, and fonts

Previously, it was only possible to read theme information via the API. Now themes, color palettes, and fonts can also be created and updated. For customers with many accounts or strict branding, this means:

A central brand manager can distribute approved colors and fonts to all accounts automatically
Changing a visual profile can be done in a single system call instead of manually on each account
An agency platform can create fully configured accounts with the correct design from day one

Webhooks — get notified when something happens

Webhooks allow PinToMind to notify another system in real time when something occurs, without the other system needing to poll repeatedly.

Supported events:

Screen goes offline/online — send alerts to your monitoring system as soon as a screen loses connection, or confirm that it is back
Screen connected or disconnected from the account — useful for automatic provisioning in larger rollouts
External resource fails to fetch data — for example, a calendar integration stops working; get notified the first time it happens, not when someone randomly notices it on the screen

All webhooks are cryptographically signed, so the receiving system can confirm that the request actually came from PinToMind.

Support for AI development

We have created a dedicated documentation page in markdown designed for AI agents, which means you can download the page and give it to an AI agent that will then be able to create an integration using our API. You can find this at the bottom of the API documentation.

Along with expanding the API, we have also created a program that uses the API in a simple way. It can be downloaded from https://github.com/favo/pintomind-cli and is publicly available.

It can be used to create a simple integration in other systems without having to mess with HTTP requests, or it can be used directly from an AI agent like Claude / Codex.

To get started, you need an API key, and then you can install the program (works automatically on Mac and Linux) with the command:

curl -fsSL https://dl.pintomind.com/pintomind-cli/install.sh | sh

To set up support for AI integration, run:

pintomind setup all

You can have multiple accounts simultaneously, with multiple API keys, but you need at least one to do anything. Add a key by typing:

pintomind connection add <name> <api-key>

After that, it is possible to control your infoscreens from the command line. There are several examples in the readme. It is, of course, a bit complex, but it may be easier to automate some tasks with this tool than to build everything yourself.

Summary

With update 3.1.17, the API is no longer limited to reading and controlling screens. It is now possible to build full integrations where PinToMind is a natural part of a larger information flow — where content is created, managed, and removed automatically based on what happens in the organization’s own systems.