Setup_Walkthrough

What this skill does

The Setup Walkthrough skill guides users through connecting an Instagram Business or Creator account to a Meta developer app using OAuth authentication. It covers creating a Meta app, configuring Instagram API access, setting OAuth redirect URIs, obtaining app credentials, adding testers for development mode, and requesting necessary Instagram and Facebook permissions. The process culminates in running an authorization script that generates a long-lived access token tied to the Instagram account, enabling API calls for content publishing, insights, and messaging.

Who it's for

This skill is designed for performance marketers managing Instagram Business profiles who need programmatic access to publish content or retrieve insights. It also suits growth teams integrating Instagram data into their marketing stacks via Meta’s APIs. Agency strategists handling multiple client accounts benefit from setting up tester roles and permissions to manage development and production environments securely.

Key workflows

First, the practitioner creates a Business-type Meta app through the Meta for Developers platform, ensuring the app is linked to their Instagram Business or Creator account via an associated Facebook Page. Next, they add the Instagram Graph API product to the app and configure OAuth by specifying the valid redirect URIs. Then, they collect the App ID and App Secret to run the provided `auth.py` script, which automates the OAuth flow, token exchange, and account discovery. Finally, they verify setup success by checking token validity and retrieving profile or media data through test scripts.

Common questions

What if my Instagram account isn’t Business or Creator? You must upgrade it to Business or Creator and link it to a Facebook Page to use this skill. How do I handle token expiration? The long-lived token lasts 60 days and can be refreshed automatically via the provided script when close to expiry. What if I get permission denied errors? Confirm the app has requested and been granted all required Instagram and Facebook permissions, and re-run authorization if necessary.

How to use in Metaflow

Attach the Setup Walkthrough skill to a Metaflow agent task to automate the Meta app creation and OAuth token generation as part of your workflow. Expect the agent to prompt for app credentials, open the authorization URL, and store tokens and account info for downstream API calls. This integration streamlines onboarding Instagram Business accounts for data-driven marketing actions within Metaflow’s ecosystem.

For broader context, see our roundup of claude skills for marketing, and read best Claude skills for marketing agencies for related setup guidance.