// Social integration · 9 steps · ~15 min

Instagram Setup

Get your Page Access Token and Instagram Business Account ID. Plan on 15 to 20 minutes the first time. Once it's saved in ArtDrop, the token is effectively permanent.

// You will end up with
// Before you start, confirm all three
  1. 1
    Instagram app

    Switch to a Business or Creator account and link your Facebook Page

    Open the Instagram mobile app (the web doesn't expose these options):

    1. Tap your profile picture, then the hamburger menu (top right).
    2. Tap Settings and activity, then Account type and tools.
    3. Tap Switch to professional account, pick a category, then choose Business (Creator also works).
    4. Back on Account type and tools, tap Share to other apps, then Facebook, and select the Page to link.

    Personal Instagram accounts can't publish through the API. If you skip this step, every other step will still look like it worked until Step 8, where instagram_business_account will come back empty.

  2. 2
    Meta for Developers

    Create a Meta developer app

    1. Go to developers.facebook.com, log in with the same Facebook account that admins your Page.
    2. Top right, My Apps, then Create app.
    3. Use case: choose Other, then Next.
    4. App type: choose Business, then Next. (Consumer won't expose the Instagram Graph product.)
    5. Name the app something like ArtDrop Personal, add a contact email, pick or create a Business Portfolio, then Create app. Pass the security check.
  3. 3
    Add products

    Add the Instagram product to the app

    1. In the app dashboard left nav, click App settings, then the + Add products row at the bottom.
    2. Find the Instagram card, click Set up.
    3. In the Instagram sidebar, open API setup with Facebook Login. This is the path that matches the scopes ArtDrop needs.
    4. Under 1. Generate access tokens, click Add account, complete Facebook Login, and grant every permission when prompted.
  4. 4
    Permissions

    Confirm the required scopes

    When the Facebook Login consent screen appears, or under App Review, Permissions and Features, these five must be present:

    • instagram_basic
    • instagram_content_publish
    • pages_show_list
    • pages_read_engagement
    • pages_manage_posts

    About App Review: you don't need to submit anything for a single-user setup. While the app is in Development mode, anyone listed under App roles, Roles (Admin, Developer, or Tester) can use every scope fully. You already have the Admin role because you created the app. Skip App Review entirely.

  5. 5
    Graph API Explorer

    Generate a short-lived User Access Token

    1. Open developers.facebook.com/tools/explorer.
    2. Top right, Meta App dropdown: pick the app you just made.
    3. User or Page dropdown: select User Token.
    4. Click Add a Permission and check each of the five scopes from Step 4.
    5. Click Generate Access Token. Log in in the popup, Continue as [you], and grant access to the target Page.
    6. Copy the token that appears in the token field. It's valid for about 1 hour, so finish Steps 6 through 8 in the same sitting.
  6. 6
    Token exchange

    Trade the short-lived token for a long-lived one (60 days)

    In the Explorer address bar, or curl, call the token exchange endpoint. You need your App ID and App Secret: find them under App settings, Basic in the dashboard (click Show next to the secret).

    GET https://graph.facebook.com/v21.0/oauth/access_token
        ?grant_type=fb_exchange_token
        &client_id={APP_ID}
        &client_secret={APP_SECRET}
        &fb_exchange_token={SHORT_USER_TOKEN}

    The response has an access_token that's good for roughly 60 days.

  7. 7
    Page token

    Pull the never-expiring Page Access Token

    Call /me/accounts with the long-lived user token from Step 6:

    GET https://graph.facebook.com/v21.0/me/accounts
        ?access_token={LONG_LIVED_USER_TOKEN}

    You get back an array of Pages. Find the Page linked to your Instagram account and copy two fields:

    • id, this is the Page ID. You'll need it in Step 8.
    • access_token, this is the Page Access Token. Paste it into ArtDrop's Page Access Token field for Instagram.

    Page tokens derived from a long-lived user token don't expire, as long as you stay admin on the Page and don't change your Facebook password. If either of those changes, repeat Steps 5 through 7 to mint a new one.

  8. 8
    Find your IG ID

    Look up your Instagram Business Account ID

    Use the Page ID and Page Access Token from Step 7:

    GET https://graph.facebook.com/v21.0/{PAGE_ID}
        ?fields=instagram_business_account
        &access_token={PAGE_ACCESS_TOKEN}

    Response looks like:

    { "instagram_business_account": { "id": "17841400000000000" } }

    Copy the numeric id. That's your Instagram Business Account ID, paste it into ArtDrop.

    If instagram_business_account is missing or null, Step 1 didn't complete. Go back to the Instagram app, Account type and tools, Share to other apps, Facebook, and make sure the Page is selected.

  9. 9
    Paste and save

    Paste both values into ArtDrop

    Back in ArtDrop's Social page, fill in the Instagram section:

    • Page Access Token: the never-expiring Page token from Step 7.
    • Business Account ID: the numeric ID from Step 8.

    Hit Save. ArtDrop runs a round-trip test against /me?fields=id immediately, so you'll know within a second if anything is off.

// Common gotchas
// Stuck?

Nine steps is a lot. If something doesn't match what you're seeing, Meta probably moved a button again. Email support@getartdrop.com with a screenshot and we'll walk you through it, or log in on your behalf if you share a temporary admin role.

Official reference: Instagram Platform Overview, Content Publishing.