Introduction

What is Sofia API?

Sofia API gives your code access to your Sofia account: the establishments of your Workspaces, their connected networks, their media library, their posts and their statistics. It is a REST API over HTTPS. Requests and responses are JSON, and every endpoint lives under one base URL.

https://api.sofia-post.com/api/v1

What can the API do?

• Publish posts: now, at a date, or as a draft, to one or several networks at once.
• Check before publishing: a dry run tells you whether each network would accept the post, and writes nothing.
• Manage media: upload a file or import it from a URL into the media library of an establishment.
• Follow posts: read the state of each network, its permalink, or the reason it failed. A signed webhook can also tell you.
• Read statistics: the latest figures Sofia collected for each connected account.
• Connect networks: create a hosted link that lets the owner connect a missing network.

Who is it for?

For a developer who automates their own Workspace, a personal key is enough: create it in Settings › API and send it as a Bearer token. For a SaaS product that acts for its users on their own Workspaces, register an OAuth client: each person authorizes your application on the Workspace they choose.

Next steps

• Quickstart: a key and a first call.
• Authentication: personal keys, OAuth with PKCE, client credentials.
• Your first post: from the media to the published post.
• API reference: every endpoint, with a playground to try it.