Instagram-posts publish

curl --request POST \
  --url https://api.adside.ai/v1/workspaces/{workspaceId}/meta/instagram-posts/publish \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "media": [
    {
      "asset_id": "<string>",
      "url": "<string>",
      "alt_text": "<string>",
      "user_tags": [
        {
          "username": "<string>",
          "x": 0.5,
          "y": 0.5
        }
      ]
    }
  ],
  "text": "<string>",
  "collaborators": [
    "<string>"
  ],
  "location_id": "<string>",
  "user_tags": [
    {
      "username": "<string>",
      "x": 0.5,
      "y": 0.5
    }
  ],
  "share_to_feed": true,
  "cover": {
    "asset_id": "<string>",
    "url": "<string>"
  },
  "cover_time_ms": 4503599627370495,
  "audio_name": "<string>",
  "instagram_account_id": "<string>",
  "ai_generated": true,
  "allow_duplicate": false,
  "wait_seconds": 180,
  "confirmationToken": "<string>"
}
'

import requests

url = "https://api.adside.ai/v1/workspaces/{workspaceId}/meta/instagram-posts/publish"

payload = {
    "media": [
        {
            "asset_id": "<string>",
            "url": "<string>",
            "alt_text": "<string>",
            "user_tags": [
                {
                    "username": "<string>",
                    "x": 0.5,
                    "y": 0.5
                }
            ]
        }
    ],
    "text": "<string>",
    "collaborators": ["<string>"],
    "location_id": "<string>",
    "user_tags": [
        {
            "username": "<string>",
            "x": 0.5,
            "y": 0.5
        }
    ],
    "share_to_feed": True,
    "cover": {
        "asset_id": "<string>",
        "url": "<string>"
    },
    "cover_time_ms": 4503599627370495,
    "audio_name": "<string>",
    "instagram_account_id": "<string>",
    "ai_generated": True,
    "allow_duplicate": False,
    "wait_seconds": 180,
    "confirmationToken": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    media: [
      {
        asset_id: '<string>',
        url: '<string>',
        alt_text: '<string>',
        user_tags: [{username: '<string>', x: 0.5, y: 0.5}]
      }
    ],
    text: '<string>',
    collaborators: ['<string>'],
    location_id: '<string>',
    user_tags: [{username: '<string>', x: 0.5, y: 0.5}],
    share_to_feed: true,
    cover: {asset_id: '<string>', url: '<string>'},
    cover_time_ms: 4503599627370495,
    audio_name: '<string>',
    instagram_account_id: '<string>',
    ai_generated: true,
    allow_duplicate: false,
    wait_seconds: 180,
    confirmationToken: '<string>'
  })
};

fetch('https://api.adside.ai/v1/workspaces/{workspaceId}/meta/instagram-posts/publish', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.adside.ai/v1/workspaces/{workspaceId}/meta/instagram-posts/publish",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'media' => [
        [
                'asset_id' => '<string>',
                'url' => '<string>',
                'alt_text' => '<string>',
                'user_tags' => [
                                [
                                                                'username' => '<string>',
                                                                'x' => 0.5,
                                                                'y' => 0.5
                                ]
                ]
        ]
    ],
    'text' => '<string>',
    'collaborators' => [
        '<string>'
    ],
    'location_id' => '<string>',
    'user_tags' => [
        [
                'username' => '<string>',
                'x' => 0.5,
                'y' => 0.5
        ]
    ],
    'share_to_feed' => true,
    'cover' => [
        'asset_id' => '<string>',
        'url' => '<string>'
    ],
    'cover_time_ms' => 4503599627370495,
    'audio_name' => '<string>',
    'instagram_account_id' => '<string>',
    'ai_generated' => true,
    'allow_duplicate' => false,
    'wait_seconds' => 180,
    'confirmationToken' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.adside.ai/v1/workspaces/{workspaceId}/meta/instagram-posts/publish"

	payload := strings.NewReader("{\n  \"media\": [\n    {\n      \"asset_id\": \"<string>\",\n      \"url\": \"<string>\",\n      \"alt_text\": \"<string>\",\n      \"user_tags\": [\n        {\n          \"username\": \"<string>\",\n          \"x\": 0.5,\n          \"y\": 0.5\n        }\n      ]\n    }\n  ],\n  \"text\": \"<string>\",\n  \"collaborators\": [\n    \"<string>\"\n  ],\n  \"location_id\": \"<string>\",\n  \"user_tags\": [\n    {\n      \"username\": \"<string>\",\n      \"x\": 0.5,\n      \"y\": 0.5\n    }\n  ],\n  \"share_to_feed\": true,\n  \"cover\": {\n    \"asset_id\": \"<string>\",\n    \"url\": \"<string>\"\n  },\n  \"cover_time_ms\": 4503599627370495,\n  \"audio_name\": \"<string>\",\n  \"instagram_account_id\": \"<string>\",\n  \"ai_generated\": true,\n  \"allow_duplicate\": false,\n  \"wait_seconds\": 180,\n  \"confirmationToken\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.adside.ai/v1/workspaces/{workspaceId}/meta/instagram-posts/publish")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"media\": [\n    {\n      \"asset_id\": \"<string>\",\n      \"url\": \"<string>\",\n      \"alt_text\": \"<string>\",\n      \"user_tags\": [\n        {\n          \"username\": \"<string>\",\n          \"x\": 0.5,\n          \"y\": 0.5\n        }\n      ]\n    }\n  ],\n  \"text\": \"<string>\",\n  \"collaborators\": [\n    \"<string>\"\n  ],\n  \"location_id\": \"<string>\",\n  \"user_tags\": [\n    {\n      \"username\": \"<string>\",\n      \"x\": 0.5,\n      \"y\": 0.5\n    }\n  ],\n  \"share_to_feed\": true,\n  \"cover\": {\n    \"asset_id\": \"<string>\",\n    \"url\": \"<string>\"\n  },\n  \"cover_time_ms\": 4503599627370495,\n  \"audio_name\": \"<string>\",\n  \"instagram_account_id\": \"<string>\",\n  \"ai_generated\": true,\n  \"allow_duplicate\": false,\n  \"wait_seconds\": 180,\n  \"confirmationToken\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.adside.ai/v1/workspaces/{workspaceId}/meta/instagram-posts/publish")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"media\": [\n    {\n      \"asset_id\": \"<string>\",\n      \"url\": \"<string>\",\n      \"alt_text\": \"<string>\",\n      \"user_tags\": [\n        {\n          \"username\": \"<string>\",\n          \"x\": 0.5,\n          \"y\": 0.5\n        }\n      ]\n    }\n  ],\n  \"text\": \"<string>\",\n  \"collaborators\": [\n    \"<string>\"\n  ],\n  \"location_id\": \"<string>\",\n  \"user_tags\": [\n    {\n      \"username\": \"<string>\",\n      \"x\": 0.5,\n      \"y\": 0.5\n    }\n  ],\n  \"share_to_feed\": true,\n  \"cover\": {\n    \"asset_id\": \"<string>\",\n    \"url\": \"<string>\"\n  },\n  \"cover_time_ms\": 4503599627370495,\n  \"audio_name\": \"<string>\",\n  \"instagram_account_id\": \"<string>\",\n  \"ai_generated\": true,\n  \"allow_duplicate\": false,\n  \"wait_seconds\": 180,\n  \"confirmationToken\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Instagram-posts publish

Publish an image post, carousel, Reel or Story to this workspace’s Instagram account, publicly. Files come from the asset library (asset_id) or a public HTTPS link; Adside converts them to what Instagram takes, then Instagram processes them, and this call WAITS (up to wait_seconds, default 3 minutes) for the post to go live. Images usually come back published in one call, with the permalink; videos may come back processing. If the answer says processing, call adside meta instagram-publications get (it waits too) until it changes. Never end the task on an unfinished publish, and never call this again for the same post: a second call is a second public post. An unknown outcome means the post may be live: tell the person to check the profile, and publish again only if they ask, with allow_duplicate. If you wrote or changed any of it (a caption you drafted, hashtags you added, a translation, a file you picked or generated that the person didn’t name), first show the exact post (with render_ui when you have it) and ask: the account, the format, every file in order with its alt text and tags, the cover, the full caption, collaborators, location, the AI label, that the post is public, and that the caption can’t be edited after posting. A clear request for a post the person wrote or saw publishes right away; an ambiguous one gets one question first.

CLI: adside meta instagram-posts publish

POST

workspaces

{workspaceId}

meta

instagram-posts

publish

Instagram-posts publish

curl --request POST \
  --url https://api.adside.ai/v1/workspaces/{workspaceId}/meta/instagram-posts/publish \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "media": [
    {
      "asset_id": "<string>",
      "url": "<string>",
      "alt_text": "<string>",
      "user_tags": [
        {
          "username": "<string>",
          "x": 0.5,
          "y": 0.5
        }
      ]
    }
  ],
  "text": "<string>",
  "collaborators": [
    "<string>"
  ],
  "location_id": "<string>",
  "user_tags": [
    {
      "username": "<string>",
      "x": 0.5,
      "y": 0.5
    }
  ],
  "share_to_feed": true,
  "cover": {
    "asset_id": "<string>",
    "url": "<string>"
  },
  "cover_time_ms": 4503599627370495,
  "audio_name": "<string>",
  "instagram_account_id": "<string>",
  "ai_generated": true,
  "allow_duplicate": false,
  "wait_seconds": 180,
  "confirmationToken": "<string>"
}
'

import requests

url = "https://api.adside.ai/v1/workspaces/{workspaceId}/meta/instagram-posts/publish"

payload = {
    "media": [
        {
            "asset_id": "<string>",
            "url": "<string>",
            "alt_text": "<string>",
            "user_tags": [
                {
                    "username": "<string>",
                    "x": 0.5,
                    "y": 0.5
                }
            ]
        }
    ],
    "text": "<string>",
    "collaborators": ["<string>"],
    "location_id": "<string>",
    "user_tags": [
        {
            "username": "<string>",
            "x": 0.5,
            "y": 0.5
        }
    ],
    "share_to_feed": True,
    "cover": {
        "asset_id": "<string>",
        "url": "<string>"
    },
    "cover_time_ms": 4503599627370495,
    "audio_name": "<string>",
    "instagram_account_id": "<string>",
    "ai_generated": True,
    "allow_duplicate": False,
    "wait_seconds": 180,
    "confirmationToken": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    media: [
      {
        asset_id: '<string>',
        url: '<string>',
        alt_text: '<string>',
        user_tags: [{username: '<string>', x: 0.5, y: 0.5}]
      }
    ],
    text: '<string>',
    collaborators: ['<string>'],
    location_id: '<string>',
    user_tags: [{username: '<string>', x: 0.5, y: 0.5}],
    share_to_feed: true,
    cover: {asset_id: '<string>', url: '<string>'},
    cover_time_ms: 4503599627370495,
    audio_name: '<string>',
    instagram_account_id: '<string>',
    ai_generated: true,
    allow_duplicate: false,
    wait_seconds: 180,
    confirmationToken: '<string>'
  })
};

fetch('https://api.adside.ai/v1/workspaces/{workspaceId}/meta/instagram-posts/publish', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.adside.ai/v1/workspaces/{workspaceId}/meta/instagram-posts/publish",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'media' => [
        [
                'asset_id' => '<string>',
                'url' => '<string>',
                'alt_text' => '<string>',
                'user_tags' => [
                                [
                                                                'username' => '<string>',
                                                                'x' => 0.5,
                                                                'y' => 0.5
                                ]
                ]
        ]
    ],
    'text' => '<string>',
    'collaborators' => [
        '<string>'
    ],
    'location_id' => '<string>',
    'user_tags' => [
        [
                'username' => '<string>',
                'x' => 0.5,
                'y' => 0.5
        ]
    ],
    'share_to_feed' => true,
    'cover' => [
        'asset_id' => '<string>',
        'url' => '<string>'
    ],
    'cover_time_ms' => 4503599627370495,
    'audio_name' => '<string>',
    'instagram_account_id' => '<string>',
    'ai_generated' => true,
    'allow_duplicate' => false,
    'wait_seconds' => 180,
    'confirmationToken' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.adside.ai/v1/workspaces/{workspaceId}/meta/instagram-posts/publish"

	payload := strings.NewReader("{\n  \"media\": [\n    {\n      \"asset_id\": \"<string>\",\n      \"url\": \"<string>\",\n      \"alt_text\": \"<string>\",\n      \"user_tags\": [\n        {\n          \"username\": \"<string>\",\n          \"x\": 0.5,\n          \"y\": 0.5\n        }\n      ]\n    }\n  ],\n  \"text\": \"<string>\",\n  \"collaborators\": [\n    \"<string>\"\n  ],\n  \"location_id\": \"<string>\",\n  \"user_tags\": [\n    {\n      \"username\": \"<string>\",\n      \"x\": 0.5,\n      \"y\": 0.5\n    }\n  ],\n  \"share_to_feed\": true,\n  \"cover\": {\n    \"asset_id\": \"<string>\",\n    \"url\": \"<string>\"\n  },\n  \"cover_time_ms\": 4503599627370495,\n  \"audio_name\": \"<string>\",\n  \"instagram_account_id\": \"<string>\",\n  \"ai_generated\": true,\n  \"allow_duplicate\": false,\n  \"wait_seconds\": 180,\n  \"confirmationToken\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.adside.ai/v1/workspaces/{workspaceId}/meta/instagram-posts/publish")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"media\": [\n    {\n      \"asset_id\": \"<string>\",\n      \"url\": \"<string>\",\n      \"alt_text\": \"<string>\",\n      \"user_tags\": [\n        {\n          \"username\": \"<string>\",\n          \"x\": 0.5,\n          \"y\": 0.5\n        }\n      ]\n    }\n  ],\n  \"text\": \"<string>\",\n  \"collaborators\": [\n    \"<string>\"\n  ],\n  \"location_id\": \"<string>\",\n  \"user_tags\": [\n    {\n      \"username\": \"<string>\",\n      \"x\": 0.5,\n      \"y\": 0.5\n    }\n  ],\n  \"share_to_feed\": true,\n  \"cover\": {\n    \"asset_id\": \"<string>\",\n    \"url\": \"<string>\"\n  },\n  \"cover_time_ms\": 4503599627370495,\n  \"audio_name\": \"<string>\",\n  \"instagram_account_id\": \"<string>\",\n  \"ai_generated\": true,\n  \"allow_duplicate\": false,\n  \"wait_seconds\": 180,\n  \"confirmationToken\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.adside.ai/v1/workspaces/{workspaceId}/meta/instagram-posts/publish")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"media\": [\n    {\n      \"asset_id\": \"<string>\",\n      \"url\": \"<string>\",\n      \"alt_text\": \"<string>\",\n      \"user_tags\": [\n        {\n          \"username\": \"<string>\",\n          \"x\": 0.5,\n          \"y\": 0.5\n        }\n      ]\n    }\n  ],\n  \"text\": \"<string>\",\n  \"collaborators\": [\n    \"<string>\"\n  ],\n  \"location_id\": \"<string>\",\n  \"user_tags\": [\n    {\n      \"username\": \"<string>\",\n      \"x\": 0.5,\n      \"y\": 0.5\n    }\n  ],\n  \"share_to_feed\": true,\n  \"cover\": {\n    \"asset_id\": \"<string>\",\n    \"url\": \"<string>\"\n  },\n  \"cover_time_ms\": 4503599627370495,\n  \"audio_name\": \"<string>\",\n  \"instagram_account_id\": \"<string>\",\n  \"ai_generated\": true,\n  \"allow_duplicate\": false,\n  \"wait_seconds\": 180,\n  \"confirmationToken\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Authorizations

Authorization

string

header

required

A personal API key (adside_pat_…) or a token from adside login. Either carries the permissions of the person it belongs to.

Path Parameters

workspaceId

string

required

Minimum string length: 1

Body

application/json

format

enum<string>

required

image: one image in the feed. carousel: 2 to 20 images and videos in one post. reel: one video. story: one image or video for 24 hours.

Available options:

image,

carousel,

reel,

story

media

object[]

required

The files, in the order they appear. One for image, reel and story; 2 to 20 for carousel. Images that aren't a JPEG are converted, and videos are converted to Instagram's MP4 when needed; feed and carousel images must already be 4:5 to 1.91:1 (nothing is cropped).

Required array length: 1 - 20 elements

Show child attributes

text

string

The caption, exactly as it will appear: up to 2200 characters, 30 hashtags and 20 mentions. It can't be edited after posting. Not on Stories.

Maximum string length: 2200

collaborators

string[]

Up to 3 public professional accounts invited as collaborators. Not on Stories.

Maximum array length: 3

An Instagram username, with or without @

Pattern: ^@?[A-Za-z0-9._]{1,30}$

location_id

string

The id of a Facebook Page that has a location. Not on Stories.

Pattern: ^\d+$

user_tags

object[]

Accounts tagged on a Reel (username only) or a Story. On image posts and carousels, tag each image in media[].user_tags instead.

Maximum array length: 20

Show child attributes

Reels only: false keeps the Reel to the Reels tab. Instagram shows it on the Feed too by default.

cover

object

Reels only: a cover image. Exactly one of asset_id or url.

Show child attributes

cover_time_ms

integer

Reels only: the frame to use as the cover, in milliseconds from the start. Not with cover.

Required range: 0 <= x <= 9007199254740991

audio_name

string

Reels only: the name the Reel's original audio gets.

Minimum string length: 1

trial

object

Reels only: a trial Reel, shown to non-followers first.

Show child attributes

instagram_account_id

string

Omit it: the post goes to this workspace's Instagram account, and any other account is refused.

Pattern: ^\d+$

ai_generated

boolean

Meta's AI label. Omit it: it is on when any file was generated or derived from a generated Asset.

allow_duplicate

boolean

default:false

By default, the same post to the same account within 24 hours returns that publication instead of posting again. Set true only when the person wants a second post, or after checking the profile following an unknown outcome.

wait_seconds

integer

default:180

Seconds to wait for the post to go live (or fail) before answering. Default 180, max 240. Leave the default: one call usually returns the live post. 0 answers at once.

Required range: 0 <= x <= 240

confirmationToken

string

Response

200 - application/json

Success