Your First Post

Integrating social media publishing into your application shouldn't take weeks. With Post for Me, you can execute your first cross-platform post in just three simple API calls.

Here is a breakdown of the core workflow to get your "Hello World" post live.

Project Setup

Before you can write any code to connect accounts, you must configure your project to allow specific networks.

How it works

Navigate to your Post for Me project dashboard and explicitly enable the platforms you want to support (such as Facebook, X, or Instagram). If you skip this step, the authentication flow will fail because the API will not know which credentials to use.

Step 1: Connect an Account

To post on a user's behalf, you must securely authenticate their social profile and obtain the necessary access tokens.

How it works

Make a POST request to the /v1/social-accounts/auth-url endpoint, passing the target platform in the body. The API will return a secure url.

You redirect your user to this URL. They will see an OAuth screen asking them to grant your application access to their account. Once approved, they are seamlessly redirected back to your application.

Step 2: Retrieve the Account ID

Every post requires a specific target destination, represented by a unique social_account_id.

How it works

Once the user completes the connection flow, make a GET request to the /v1/social-accounts endpoint. You can filter this request by passing query parameters like ?platform=facebook.

The API returns an array of connected accounts. Extract the id (e.g., spc_12345) from the returned data. You will use this ID to tell the API exactly where to send the content.

Step 3: Publish the Post

The final step is compiling your content and sending it to our servers for distribution.

How it works

Make a POST request to the /v1/social-posts endpoint. Your JSON payload needs two primary fields at a minimum:

• A caption string for the text of the post.

• A social_accounts array containing the IDs you retrieved in Step 2.

Note: If you are posting instantly, do not include a scheduled_at parameter.

The API returns a Social Post object with a status of processing. Within moments, the post will be distributed, and its status will change to processed as it goes live on the selected native social media platforms!