Instagram Settings

API settings for posting to Instagram

Settings Schema

When creating a post for Instagram, use the following settings schema:

{
  "settings": {
    "__type": "instagram",
    "post_type": "post",
    "is_trial_reel": false,
    "collaborators": []
  }
}

info

Use __type: "instagram" for Facebook Business-linked accounts and __type: "instagram-standalone" for standalone Instagram accounts. Both use the same settings schema.

Fields

Field	Type	Required	Description
__type	string	Yes	instagram or instagram-standalone
post_type	string	Yes	Type of Instagram post
is_trial_reel	boolean	No	Whether to post as a trial reel
graduation_strategy	string	No	Graduation strategy for trial reels
collaborators	array	No	List of collaborator usernames

post_type

Value	Description
post	Regular feed post
story	Instagram Story (24-hour visibility)

is_trial_reel

When set to true, the post will be published as a trial reel with limited initial visibility.

graduation_strategy

Controls how trial reels graduate to full visibility. Only applicable when is_trial_reel is true.

Value	Description
MANUAL	Manually graduate the reel
SS_PERFORMANCE	Automatically graduate based on performance

collaborators

Array of collaborator objects. Each collaborator will receive an invite to be added as a collaborator on the post.

{
  "collaborators": [
    { "label": "username1" },
    { "label": "username2" }
  ]
}

---

Complete Example

Feed Post

{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-instagram-integration-id"
      },
      "value": [
        {
          "content": "Beautiful sunset today! 🌅\n\n#sunset #photography #nature",
          "image": [
            {
              "id": "image-id",
              "path": "https://uploads.sipstory.tech/sunset.jpg"
            }
          ]
        }
      ],
      "settings": {
        "__type": "instagram",
        "post_type": "post",
        "is_trial_reel": false,
        "collaborators": []
      }
    }
  ]
}

Story Post

{
  "type": "now",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-instagram-integration-id"
      },
      "value": [
        {
          "content": "",
          "image": [
            {
              "id": "story-image-id",
              "path": "https://uploads.sipstory.tech/story.jpg"
            }
          ]
        }
      ],
      "settings": {
        "__type": "instagram",
        "post_type": "story"
      }
    }
  ]
}

Collaborative Post

{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-instagram-integration-id"
      },
      "value": [
        {
          "content": "Amazing collab with @partner! 🤝",
          "image": [
            {
              "id": "collab-image-id",
              "path": "https://uploads.sipstory.tech/collab.jpg"
            }
          ]
        }
      ],
      "settings": {
        "__type": "instagram",
        "post_type": "post",
        "collaborators": [
          { "label": "partner_username" }
        ]
      }
    }
  ]
}

Carousel Post

Create a carousel by adding multiple images:

{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-instagram-integration-id"
      },
      "value": [
        {
          "content": "Swipe to see all the photos! 📸",
          "image": [
            { "id": "img1", "path": "https://uploads.sipstory.tech/1.jpg" },
            { "id": "img2", "path": "https://uploads.sipstory.tech/2.jpg" },
            { "id": "img3", "path": "https://uploads.sipstory.tech/3.jpg" }
          ]
        }
      ],
      "settings": {
        "__type": "instagram",
        "post_type": "post"
      }
    }
  ]
}