1. 무엇이 바뀌었나

Meta는 2026년 10월 13일 인스타그램 API 안내 문서를 고치면서 연결 방식을 정리했습니다. 이제 새로 만드는 Meta 앱에서는 'Instagram 로그인' 방식을 고를 수 없습니다.
예전에는 인스타그램 프로페셔널 계정 하나만 있으면 인스타그램 계정으로 로그인해 바로 토큰을 받을 수 있었습니다. 가장 쉬운 방법이어서 인터넷의 많은 자료가 이 방식으로 설명되어 있습니다. 그런데 지금 그 자료대로 따라 하면 중간에 버튼이 보이지 않거나, 앱 화면에 이런 문구가 나옵니다.
최신 앱에서는 Instagram 로그인이 포함된 API 설정을 사용할 수 없습니다. 대신 앱이 통합된 로그인이 포함된 API 설정을 사용합니다.
화면이 틀린 것이 아니라 방식이 바뀐 것입니다. 이미 Instagram 로그인으로 만들어 둔 앱은 아직 작동합니다(종료일은 발표되지 않았습니다).
2. 내게 맞는 방식 고르기

새로 시작한다면 길은 두 가지입니다.
| 방식 | 필요한 것 | 이럴 때 |
|---|---|---|
| 통합 로그인 (새 앱의 기본) | Meta 비즈니스 인증을 마친 비즈니스 포트폴리오 | 비즈니스 인증을 마쳤을 때. Meta의 새 기능은 이 방식에만 나옵니다 |
| Facebook 로그인 | Facebook 페이지 + 페이지에 연결한 인스타그램 프로페셔널 계정 | 비즈니스 인증을 받지 않았을 때(개인, 인증 전 사업자) |
- 통합 로그인은 앱을 만들 때 비즈니스 포트폴리오를 연결해야 다음으로 넘어갑니다. 인증을 마치지 않은 포트폴리오로는 진행할 수 없었습니다.
- 비즈니스 인증은 Meta가 비즈니스의 법적 이름·주소·전화번호·웹사이트(https 주소)를 확인하는 절차입니다. 정보가 기록과 맞지 않으면 사업자등록증 같은 공식 문서를 올려야 해서, 사업자등록이 없는 개인은 받을 수 없습니다. 개인사업자는 사업자등록이 있으면 신청할 수 있습니다.
- Facebook 로그인은 "계속 작동하지만 더 이상 업데이트되지 않는다"고 안내되어 있습니다. 지금 쓰는 데는 문제가 없지만, 앞으로 Meta가 바꿀 수 있다는 점은 알아 두세요.

Meta 앱 설정 화면에 나오는 안내입니다. Instagram 로그인은 "사용할 수 없다", Facebook 로그인은 "계속 작동하지만 업데이트되지 않는다"로 서로 다르게 안내됩니다.
이 자료는 Facebook 로그인 기준입니다. 비즈니스 인증 없이 내 계정에 게시하고 성과를 조회하는 것까지 2026년 11월에 직접 확인했습니다.
3. 연결의 구조
3-1. API

API는 프로그램이 다른 서비스에 정해진 형식으로 요청을 보내고 결과를 받는 방법입니다. 사람은 인스타그램 앱 화면에서 사진을 고르고 버튼을 눌러 게시합니다. 자동화 도구는 화면 없이 인스타그램 API로 "이 계정에, 이 이미지 URL과 캡션으로 게시물을 만들어 달라"는 요청을 보냅니다.
요청마다 액세스 토큰이 함께 갑니다. Meta는 이 토큰으로 어느 앱이 어느 계정에서 어떤 권한을 허용받았는지 확인하고, 허용된 요청만 처리합니다.
3-2. 연결에 필요한 여섯 가지

| 구성 요소 | 설명 |
|---|---|
| 인스타그램 프로페셔널 계정 | 비즈니스 또는 크리에이터 계정. API로 게시하려면 이 계정 유형이어야 하며, 개인 계정은 API로 게시할 수 없습니다 |
| Facebook 페이지 | 인스타그램 프로페셔널 계정을 연결하는 Facebook 페이지. Facebook 로그인 방식에서 API는 이 페이지를 통해 인스타그램 계정을 찾습니다 |
| Meta 앱 | Meta 개발자 사이트에 등록하는 앱. 이용 사례와 권한을 설정하며, 액세스 토큰은 이 앱에 대해 발급됩니다 |
| 액세스 토큰 | 사용자가 앱에 허용한 권한이 담긴 문자열. API 요청마다 함께 보내며, 다른 사람에게 드러나면 안 됩니다 |
| 이미지 호스팅 | 사진·영상 파일을 공개 URL로 제공하는 서비스(예: Cloudinary). 인스타그램은 이 URL에서 파일을 내려받습니다 |
| 자동화 도구 | 액세스 토큰으로 API에 요청을 보내 게시와 조회를 실행하는 프로그램 |
내 계정에만 게시한다면 Meta 앱을 개발 모드로 두고 쓸 수 있습니다. 개발 모드의 앱은 앱에 역할이 있는 사용자의 계정에서만 작동합니다.
3-3. Facebook 페이지가 필요한 이유

Facebook 로그인 방식의 액세스 토큰은 Facebook 계정으로 발급됩니다. 그래서 인스타그램 계정은 다음 순서로 찾습니다.
- 토큰으로 내가 관리하는 Facebook 페이지 목록을 조회합니다.
- 그 페이지에 연결된 인스타그램 프로페셔널 계정의 번호(ID)를 조회합니다.
- 그 계정 번호로 게시하거나 인사이트를 조회합니다.
페이지와 인스타그램 계정이 연결되어 있지 않으면 2번에서 계정 번호가 나오지 않습니다. 토큰은 받았는데 인스타그램 계정을 찾지 못하는 상태가 됩니다.
3-4. 권한

권한은 액세스 토큰으로 할 수 있는 일의 범위입니다. 토큰을 받을 때 고른 권한만 쓸 수 있습니다. Facebook 로그인 방식에서는 인스타그램 권한만으로는 부족하고, 페이지를 조회하는 Facebook 페이지·비즈니스 권한이 함께 필요합니다.
토큰에 없는 권한이 필요한 요청은 권한 오류로 거절됩니다. 앱에 권한을 추가한 뒤 토큰을 다시 받아야 합니다. 이미 받은 토큰에 권한이 추가되지는 않습니다.
3-5. 액세스 토큰의 세 가지 종류

| 종류 | 설명 | 만료 |
|---|---|---|
| 단기 토큰 | 권한을 허용하면 처음 발급되는 토큰 | 1시간 |
| 확장 토큰 | 단기 토큰을 확장해 발급받는 장기 토큰 | 장기 사용 |
| 페이지 토큰 | 확장 토큰으로 발급받는, 인스타그램 계정이 연결된 Facebook 페이지의 토큰 | 만료 없음 |
단기 토큰을 그대로 저장하면 1시간 뒤 요청이 거절됩니다.
약 90일마다 다시 허용해야 합니다. 토큰에 만료가 없어도, 앱을 허용한 날로부터 약 90일이 지나면 이 앱의 데이터 접근이 끝납니다. 이것을 데이터 접근 만료라고 합니다. 그 전에 다시 허용하고 토큰을 새로 받아야 합니다.
4. 큰 순서

| 묶음 | 하는 일 |
|---|---|
| 1. 계정 준비 | 인스타그램을 프로페셔널 계정으로 전환하고, Facebook 페이지에 연결합니다 |
| 2. 앱 준비 | Meta 앱을 만들고, Facebook 로그인 방식으로 필요한 권한을 추가합니다 |
| 3. 토큰 받기 | 권한을 허용해 토큰을 받고, 확장한 뒤 페이지 토큰으로 바꿉니다 |
| 4. 보관 | 토큰과 인스타그램 계정 번호를 설정 파일(.env)에 저장합니다 |
앞 묶음이 끝나야 다음 묶음이 됩니다. 그다음 이미지 호스팅을 준비하면 자동화 도구로 첫 게시를 보낼 수 있습니다.
5. 게시할 때 안에서 일어나는 일

인스타그램 API는 PC 파일을 받지 않습니다. 공개 URL을 알려 주면 인스타그램이 그 URL에서 파일을 내려받습니다. 그래서 이미지 호스팅이 필요합니다.
| 단계 | 하는 일 | 알아 둘 것 |
|---|---|---|
| 1. 공개 주소 만들기 | 사진·영상을 이미지 호스팅에 올려 누구나 열 수 있는 URL을 받습니다 | 로그인해야 열리는 드라이브 링크는 인스타그램이 내려받지 못합니다 |
| 2. 미디어 컨테이너 만들기 | 이미지 URL과 캡션을 보내면 인스타그램이 파일을 내려받아 게시 전 단계의 컨테이너를 만듭니다 | 여러 장이면 장마다 하나씩 만든 뒤 하나로 묶습니다. 아직 계정에는 보이지 않습니다 |
| 3. 처리 기다리기 | 처리가 끝났는지 상태를 확인합니다 | 영상은 보통 1분 안팎, 인스타그램이 붐비면 몇 분 더 걸립니다 |
| 4. 게시하기 | 컨테이너를 게시하고 게시물 ID와 링크를 받습니다 | 하루(24시간) 최대 100건 |
4단계에서 오류가 나도 이미 올라갔을 수 있습니다. 다시 보내기 전에 계정을 먼저 확인하세요. 그래야 같은 글이 두 번 올라가지 않습니다.
6. 액세스 토큰 보관 원칙

토큰만 있으면 다른 사람도 내 계정에 글을 올릴 수 있습니다.
- 둘 곳은 내 컴퓨터의 설정 파일(.env) 한 곳입니다. 토큰은 내가 직접 붙여 넣습니다.
- AI 대화창에 붙여 넣지 않습니다. AI 도구에게는 "토큰은 .env에 있다"고만 알려 주고, 프로그램이 파일에서 직접 읽게 합니다.
- 토큰이 보이는 화면은 캡처하거나 공유하지 않습니다. 메신저·메일·게시판에도 올리지 않습니다.
- 잘 만든 프로그램은 오류 메시지나 기록에 토큰이 찍히지 않게 가립니다.
실수로 드러났다면 Facebook 설정의 비즈니스 통합에서 이 앱의 연결을 지우거나 Facebook 비밀번호를 바꿉니다. 그러면 그 토큰은 더 이상 쓸 수 없습니다. 그다음 토큰을 새로 받습니다.
7. 자주 막히는 지점
| 증상 | 원인 |
|---|---|
| 'Instagram 로그인'이 보이지 않는다 | 2026년 10월 방식 변경 |
| 비즈니스 포트폴리오를 연결하라며 넘어가지 않는다 | 통합 로그인 설정을 고름(인증된 포트폴리오 필요) |
| 토큰은 받았는데 인스타그램 계정이 나오지 않는다 | 페이지와 인스타그램 계정이 연결되지 않음 |
| 권한이 없다는 오류 | 필요한 권한이 토큰에 없음 |
| 토큰이 만료됐거나 잘못됐다는 오류 | 단기 토큰을 그대로 씀, 비밀번호 변경, 데이터 접근 만료 |
| 사진·영상을 가져가지 못했다는 오류 | URL이 공개되어 있지 않음 |
8. 한 장 정리
- 2026년 10월부터 새 앱에서는 Instagram 로그인을 고를 수 없습니다. 비즈니스 인증을 받지 않았다면 Facebook 로그인으로 연결합니다.
- Facebook 로그인은 Facebook 페이지를 거쳐 인스타그램 계정을 찾습니다. 페이지와 계정 연결이 첫 단계입니다.
- 액세스 토큰은 앱에 허용한 권한이 담긴 문자열입니다. 토큰을 받을 때 고른 권한만 쓸 수 있습니다.
- 토큰은 단기 토큰(1시간) → 확장 토큰 → 페이지 토큰(만료 없음) 순서로 받고, 약 90일마다 다시 허용합니다.
- 인스타그램은 PC 파일 대신 공개 URL에서 파일을 내려받습니다. 그래서 이미지 호스팅이 필요합니다.
- 토큰은 .env 한 곳에만 두고, AI 대화창에는 붙이지 않습니다.
용어
| 용어 | 뜻 |
|---|---|
| API | 프로그램이 다른 서비스에 정해진 형식으로 요청을 보내고 결과를 받는 방법 |
| 액세스 토큰 | 사용자가 앱에 허용한 권한이 담긴 문자열 |
| 권한 | 액세스 토큰으로 할 수 있는 일의 범위 |
| Meta 앱 | Meta 개발자 사이트에 등록하는 앱. 개발 모드에서는 앱에 역할이 있는 사용자만 사용 |
| 비즈니스 인증 | Meta가 비즈니스의 법적 이름·주소·전화번호·웹사이트를 확인하는 절차. 사업자등록증 등 공식 문서가 필요합니다 |
| 페이지 토큰 | Facebook 페이지에 대해 발급되는 토큰. 만료가 없습니다 |
| 데이터 접근 만료 | 앱을 허용한 날로부터 약 90일 뒤 데이터 접근이 끝나는 날 |
| 미디어 컨테이너 | 게시 전에 인스타그램이 만들어 두는 미디어 단위. 게시 요청으로 실제 게시물이 됩니다 |
| 이미지 호스팅 | 사진·영상 파일을 공개 URL로 제공하는 서비스 |
| .env | 비밀 값을 적어 두는 내 컴퓨터의 설정 파일 |



