Quickstart

PostProxy creates your first account group automatically when you create your account. So basically all you need is to link your first social media account to your PostProxy account. Once it’s done you can you get make your first API call.

Step 1: Get accounts

You will use it to identify the account you want to post to.

cURL

curl -X GET "https://api.postproxy.dev/v1/accounts" \
     -H "Authorization: Bearer YOUR_API_KEY"

Python

import Postproxy from postproxy

client = Postproxy(api_key="YOUR_API_KEY")

accounts = client.get_accounts()
print(accounts)

Ruby

require 'postproxy'

client = Postproxy.new("YOUR_API_KEY")

accounts = client.get_accounts()
pp accounts

JS

import Postproxy from 'postproxy';

const client = new Postproxy("YOUR_API_KEY");

accounts = await client.getAccounts();
console.log(accounts)

Response:

[
  {
    "id": "777",
    "name": "My Facebook Account",
    "type": "facebook",
    "username": "myfb"
  },
  {
    "id": "778",
    "name": "My Instagram Account",
    "type": "instagram",
    "username": "myinsta"
  }
]

Note account ids 777 and 778 – we will use it later.

Step 2: Post your content immediately

Take account id and post your text with media.

cURL

curl -X POST "https://api.postproxy.dev/v1/posts" \
     -H "Authorization: Bearer YOUR_API_KEY"
     -H "Content-Type: application/json" \
     -d '{
      "content": "Hello World!",
      "media": ["https://someurl.com/happyface.jpg"],
      "accounts": [777, 778]
    }

Python

import Postproxy from postproxy

client = Postproxy(api_key="YOUR_API_KEY")

post = client.create_post(
  content="Hello World!",
  media=[
    "https://someurl.com/happyface.jpg"
  ],
  accounts=[777, 778]
)
print(post)

Ruby

require 'postproxy'

client = Postproxy.new("YOUR_API_KEY")

post = client.create_post({
  content: "Hello World!",
  media: [
    "https://someurl.com/happyface.jpg"
  ],
  accounts: [777, 778]
})
pp post

JS

import Postproxy from 'postproxy';

const client = new Postproxy("YOUR_API_KEY");

post = await client.createPost({
  content: "Hello World!",
  media: [
    "https://someurl.com/happyface.jpg"
  ],
  accounts: [777, 778]
});

console.log(post)

Response:

[
  {
    "id": "1",
    "content": "Hello World!",
    "accounts": [
      {
        "id": 777,
        "status": "processing"
      },
      {
        "id": 778,
        "status": "published"
      }
    ]
  }
]

That was it! Your post will appear online almost immediately!

Step 2a: Post your content at some moment in future

Take account id and post your text with media.

cURL

curl -X POST "https://api.postproxy.dev/v1/posts" \
     -H "Authorization: Bearer YOUR_API_KEY"
     -H "Content-Type: application/json" \
     -d '{
      "content": "Hello World!",
      "pusblish_at": "2026-01-02T12:00:00Z"
      "media": ["https://someurl.com/happyface.jpg"],
      "accounts": [777, 778]
    }

Python

import Postproxy from postproxy

client = Postproxy(api_key="YOUR_API_KEY")

post = client.create_post(
  content="Hello World!",
  pusblish_at="2026-01-02T12:00:00Z",
  media=[
    "https://someurl.com/happyface.jpg"
  ],
  accounts=[777, 778]
)
print(post)

Ruby

require 'postproxy'

client = Postproxy.new("YOUR_API_KEY")

post = client.create_post({
  content: "Hello World!",
  pusblish_at: "2026-01-02T12:00:00Z",
  media: [
    "https://someurl.com/happyface.jpg"
  ],
  accounts: [777, 778]
})
pp post

JS

import Postproxy from 'postproxy';

const client = new Postproxy("YOUR_API_KEY");

post = await client.createPost({
  content: "Hello World!",
  pusblish_at: "2026-01-02T12:00:00Z",
  media: [
    "https://someurl.com/happyface.jpg"
  ],
  accounts: [777, 778]
});

console.log(post)

Response:

[
  {
    "id": "1",
    "content": "Hello World!",
    "accounts": [
      {
        "id": 777,
        "status": "scheduled"
      },
      {
        "id": 778,
        "status": "scheduled"
      }
    ]
  }
]

That was it! When time comes we take care of the all the machinery!