Active with remarks
This application needs additional settings. Please follow the documentation below to create your own connection.

Redirect url

https://integrator.boost.space/oauth/cb/facebook

Instagram for Business

The Instagram for Business modules enables you to monitor comments and media, retrieve insights, media, and stories, as well as create comments or replies in your Instagram for Business account.

Getting Started With Instagram for Business

Prerequisites

A Facebook account that can perform admin-equivalent tasks on a Facebook Page that has been connected to the Instagram account you want to access.
An Instagram for Business account — You can create an Instagram account on instagram.com, and then switch the profile to a Business account. Please refer to the Set Up a Business Account on Instagram guide.

	Note
	The module dialog fields that are displayed in bold (in the Boost.space Integrator scenario, not in this documentation article) are mandatory!

Connecting Instagram for Business to Boost.space Integrator

Ensure that you create a connection with the same profile you are logged into on Facebook and Instagram. If you are making a connection with another account, it won’t work for you and you need to add another administrator to your application – follow our step-by-step guide. You also need to add a test user to Your Instagram app – follow our step-by-step guide.

Insights

Get User Insights

Returns insights on an Instagram user.

	Note
	Insights data is unavailable to Instagram users with fewer than 100 followers.

Connection	Establish a connection to your Instagram for Business account.
Page	Select the page or enter (map) the ID of the page you want to retrieve insights for.
Metric	Select the user metric you want to retrieve. If you want to select multiple metrics they must have the same compatible period.
Period	Select the period compatible with the metrics you have selected.
Date since	Enter the starting date to retrieve the user insights.
Date to	Enter an end date to retrieve the user insights.

Get Media Insights

Returns insights on Instagram media.

Connection

Establish a connection to your Instagram for Business account.

Media ID

Enter (map) the media ID, for example, from the Watch Media module if you want to retrieve insights.

Metrics

Select the metrics you want to retrieve for the specified media.

Please see the list of metrics that can be returned for corresponding media.

Media

Watch Media

Returns media details when new media is added.

Connection	Establish a connection to your Instagram for Business account.
Page	Select the page you want to watch for new media.
Limit	Set the maximum number of media Boost.space Integrator will return during one execution cycle. The default value is 10.

Watch Public User Media

Triggers when a new media is added to the selected Instagram Business or Creator IG User.

Connection	Establish a connection to your Instagram for Business account.
Page	Select the page whose user media you want to watch.
Username	Enter the username whose media you want to watch.
Limit	Set the maximum number of media Boost.space Integrator will return during one execution cycle.

Create a Photo Post

Posts a photo to the specified Instagram page.

	Note
	If you manage a Page with a large audience, you may be asked to confirm your identity and secure your account through a Page Publishing Authorization process.

Connection Establish a connection to your Instagram for Business account.

Page Select the page where you want to post a photo.

Photo URL

Enter the URL of the photo. The URL must be publicly accessible.

Photo Requirements

Maximum file size: 8MB
Aspect ratio: Must be within a 4:5 to 1.91:1 range
Minimum width: 320 (will be scaled up to the minimum if necessary)
Maximum width: 1440 (will be scaled down to the maximum if necessary)
Height: Varies, depending on width and aspect ratio
Formats: JPEG

	Note
	Please note that your image must be hosted on a publicly accessible URL and you cannot host your images on Google Drive even if the file is shared publicly because Instagram API is not able to download files from Google Drive. The same applies to Dropbox URLs.

Caption

Enter a caption for the photo. Like in the app, you can include hashtags (e.g., #crazywildebeest) and usernames of Instagram users (e.g., @natgeo). @Mentioned Instagram users will receive a notification when you publish the media object container.

	Note
	Maximum 2200 characters, 30 hashtags, and 20 @ tags.

User Tags

Enter the user tags.

Username

Enter the username who has a public Instagram account.

	Note
	The username should not start with `@`, it must match the pattern, `/^(?!@)/`.

X position Enter a float indicating the percentage distance from the left edge of the published media image lower than or equal to 1. This is an optional field.

Y position Enter a float indicating the percentage distance from the right edge of the published media image lower than or equal to 1. This is an optional field.

Location ID Enter the Page ID created for a physical location.

Create a Video Post

Posts a video to the specified Instagram page.

	Note
	If you manage a Page with a large audience, you may be asked to confirm your identity and secure your account through a Page Publishing Authorization process.

Connection Establish a connection to your Instagram for Business account.

Page Select the page where you want to post a video.

Video URL

Enter the URL of the video. The URL must be publicly accessible.

Video Requirements

Container: MOV or MP4 (MPEG-4 Part 14), no edit lists, Moov atom at the front of the file.
Audio codec: AAC, 48kHz sample rate maximum, 1 or 2 channels (mono or stereo).
Video codec: HEVC or H264, progressive scan, closed GOP, 4:2:0 chroma subsampling.
Frame rate: 23-60 FPS.
Picture size:
- Maximum columns (horizontal pixels): 1920
- Minimum aspect ratio [cols / rows]: 4 / 5
- Maximum aspect ratio [cols / rows]: 16 / 9
Video bitrate: VBR, 5Mbps maximum
Audio bitrate: 128kbps
Duration: 60 seconds maximum, 3 seconds minimum
File size: 100MB maximum

	Note
	Please note that your video must be hosted on a publicly accessible URL, and you cannot host your videos on Google Drive even if the file is shared publicly because Instagram API cannot download files from Google Drive. The same applies to Dropbox URLs.

Caption

Enter a caption for the video. Like in the app, you can include hashtags (e.g., #crazywildebeest) and usernames of Instagram users (e.g., @natgeo). @Mentioned users will receive a notification when you publish the media object container.

	Note
	Maximum 2200 characters, 30 hashtags, and 20 @ tags.

Location ID Enter the Page ID created for a physical location.

Create a Reel Post

Uploads and posts a new reel.

Connection Establish a connection to your Instagram for Business account.

Page

Select or map a page whose carousel post you want to create.

	Note
	Instagram Business accounts connected to a Page that requires Page Publishing Authorization (PPA) cannot be published until PPA has been completed.

Video URL

Enter the URL address of the photo. There are certain requirements for the video to be uploaded:

	Note
	You should host the video on a publicly accessible URL. Do not host the video on Google Drive even if the file is shared publicly, as Instagram API cannot download those files. The same applies to Dropbox URLs.

Container	The video should be MOV or MP4 (MPEG-4 Part 14), with no edit lists and a moov atom at the front of the file.
Audio codec	The audio code should be AAC, 48khz sample rate maximum, 1 or 2 channels (mono or stereo).
Video codec	The video codec should be HEVC or H264, progressive scan, closed GOP, 4:2:0 chroma subsampling.
Frame rate	The frame rate must be 23 – 60 FPS.
Picture size	The Maximum columns (horizontal pixels) are 1920. The required aspect ratio is between 0.01:1 and 10:1. The recommended 9:16 is to avoid cropping or blank spaces.
Video bitrate	The video bitrate (VBR) must be a maximum of 5Mbps.
Audio bitrate	The audio bitrate can be 128kpbs.
Duration	The video duration should be a maximum of 15 mins and a minimum of 3 seconds.
File Size	The video file size is a maximum of 1GB.

Caption Enter a caption for the photo. You can also include hashtags (#crazywildbeest ) and usernames of Instagram users (@natgeo). The caption can be maximum of 2200 characters, 30 hashtags, and 20 @ tags.

Location ID Enter the Page ID created for a physical location.

Share to Feed Select whether to share the reel as a feed.

Create a Carousel Post

Uploads a carousel photos/videos. as a new post.

Connection Establish a connection to your Instagram for Business account.

Page

Select or map a page whose carousel post you want to create.

	Note
	Instagram Business accounts connected to a Page that requires Page Publishing Authorization (PPA) cannot be published until PPA has been completed.

Files

Enter the details of details:

Media Type

Select the media type:

Image
Video

Photo URL

Enter the URL address of the photo. There are certain requirements for the photo to be uploaded:

	Note
	You should host the photo on a publicly accessible URL. Do not host the photo on Google Drive even if the file is shared publicly, as Instagram API cannot download those files. The same applies to Dropbox URLs.

Maximum file size	The maximum photo size should be 8MiB.
Aspect Ratio	The aspect ratio must be within the range of 4:5 to 1.9:1.
Minimum width	The minimum width is 320 and will be scaled down to the minimum when required.
Maximum width	The maximum width is 1440 and will be scaled down to the maximum when required.
Height	The height can vary depending on width and aspect ratio.
Formats	The photo must be in JPEG format.

User Tags

Enter the user tag’s details:

Username

Enter the username who has a public Instagram account.

	Note
	The username should not start with `@`, it must match the pattern, `/^(?!@)/`.

X position Enter a float indicating the percentage distance from the left edge of the published media image lower than or equal to 1. This is an optional field.

Y position Enter a float indicating the percentage distance from the right edge of the published media image lower than or equal to 1. This is an optional field.

Video URL

Enter the video’s URL address. The uploaded video must comply with the following requirements:

	Note
	Please note that your video must be hosted on a publicly accessible URL and you cannot host your videos on Google Drive even if the file is shared publicly because Instagram API is not able to download files from Google Drive. The same applies to Dropbox URLs.

Maximum file size	The maximum video file size is 100 MiB.
Picture size	The picture size should be: Maximum columns (horizontal pixels): 1920 Minimum aspect ratio [cols / rows]: 4 / 5・ Maximum aspect ratio [cols / rows]: 16 / 9
Duration	The video duration can be a maxim of 60 seconds and a minimum of 3 seconds.
Container	MOV or MP4 (MPEG-4 Part 14), no edit lists, moov atom at the front of the file.
Frame rate	The frame rate should be between 23 – 60 FPS.
Video Codec	The video codec should be HEVC or H264, progressive scan, closed GOP, 4:2:0 chroma subsampling.
Video bitrate	The bitrate can be VBR and a maximum of 5Mbps.
Audio Codec	The audio can be AAC, 48khz sample rate maximum, 1 or 2 channels (mono or stereo).
Audio bitrate	The audio bitrate should be 128kbps.

Cover Frame Enter the cover frame location in seconds of the video frame to be as the cover.

Caption Enter a caption for the photo. You can also include hashtags ( #crazywildbeest) and usernames of Instagram users (for example, @natgeo). The caption can be a maximum of 2200 characters, 30 hashtags, and 20 @ tags.

Location ID Enter the Page ID created for a physical location.

List Media

Retrieves all media from the specified Instagram page.

Connection	Establish a connection to your Instagram for Business account.
Page	Select the page you want to retrieve media from.
Limit	Set the maximum number of media Boost.space Integrator will return during one execution cycle. The default value is 10.

List Public User Media

Returns media of another Instagram Business or Creator IG User.

Connection	Establish a connection to your Instagram for Business account.
Page	Select or map a page whose public user media you want to list.
Username	Enter a username to list the media.
Limit	Set the maximum number of public user media Boost.space Integrator will return during one execution cycle. The default value is 10.

Get Media

Retrieves details of the specified media.

Connection	Establish a connection to your Instagram for Business account.
Media ID	Enter the Media ID, for example, from the Watch Media module whose details you want to retrieve.

Download a Media File

Downloads a media file.

Connection	Establish a connection to your Instagram for Business account.
Media ID	Enter (map) the media ID, for example, from the Watch Media module you want to download.

Get Album Media

Retrieves a list of all media in the specified album.

Connection	Establish a connection to your Instagram for Business account.
Media ID	Enter (map) the ID of the media album you want to retrieve media objects for.

Users

Get User Info

Retrieves information about other Instagram users.

Connection	Establish a connection to your Instagram for Business account.
Page	Select your page.
Username	Enter the username of the Instagram user you want to retrieve information about.

Comments

List Media Comments

Returns a list of IG Comments on an IG Media post.

Connection	Establish a connection to your Instagram for Business account.
Media ID	Enter a Media ID whose comments you want to list. Alternatively, you can search for a Media ID by selecting the page.
Limit	Set the maximum number of media comments Boost.space Integrator will return during one execution cycle. The default value is 10.

List Comment Replies

Returns a list of replies for a specific comment.

Connection

Establish a connection to your Instagram for Business account.

Comment ID

Enter a Comment ID whose replies you want to list. Alternatively, you can search for a Comment ID.

Page	Select or map a Page whose Media ID you want to retrieve.
Media ID	Select or map a Media ID whose comment replies you want to list.

Limit

Set the maximum number of comment replies Boost.space Integrator will return during one execution cycle. The default value is 10.

Create a Comment

Creates a comment on specified media.

Connection	Establish a connection to your Instagram for Business account.
Media ID	Enter (map) the ID of the media you want to create a comment on.
Message	Enter the text content of the comment.

Create a Reply

Replies to comment on media.

Connection	Establish a connection to your Instagram for Business account.
Comment ID	Enter (map) the ID of the comment you want to reply to.
Message	Enter the text content of the reply.

Stories

List Stories

Returns a list of stories associated with the Instagram page.

Connection	Establish a connection to your Instagram for Business account.
Page	Select the page you want to retrieve stories for.
Limit	Set the maximum number of stories Boost.space Integrator will return during one execution cycle.

Other

Watch Events

Triggers when the subscribed event is received.

	Note
	Boost.space Integrator automatically creates a webhook in Instagram for Business once you add an instant trigger to your scenario.

Webhook name	Enter a name for the webhook.
Connection	Establish a connection to your Instagram for Business account.
Page	Select the page whose events you want to watch.
Event	Select the event: Comments Mentions Story Insights