curl --request POST \
--url https://api.notifique.dev/v1/instagram/instances \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Instagram support",
"acceptInstagramTerms": true,
"auth": {
"mode": "password",
"username": "your_user",
"password": "your_password"
},
"expectedUsername": "your_user"
}
'{
"success": true,
"data": {
"id": "inst_abc",
"name": "Instagram atendimento",
"status": "ACTIVE",
"mode": "UNOFFICIAL",
"username": "seu_usuario",
"igUserPk": "17841"
}
}Create Instagram instance
Connect an Instagram account to your workspace — the profile that sends and receives DMs. Pick an example: - Unofficial: password login — Instagram username and password (accept terms).
- Unofficial: 2FA resume — when Meta asks for a verification code.
- Official: link for the customer — customer completes Meta login via link.
- Official: Meta credentials now — Meta signup already done in the browser.
- Official: your own Meta token (BYOK) — token, Page ID and IG Business ID you already have. Scope: instagram:instances:create.
curl --request POST \
--url https://api.notifique.dev/v1/instagram/instances \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Instagram support",
"acceptInstagramTerms": true,
"auth": {
"mode": "password",
"username": "your_user",
"password": "your_password"
},
"expectedUsername": "your_user"
}
'{
"success": true,
"data": {
"id": "inst_abc",
"name": "Instagram atendimento",
"status": "ACTIVE",
"mode": "UNOFFICIAL",
"username": "seu_usuario",
"igUserPk": "17841"
}
}Authorizations
Authorization: Bearer sk_live_...
Body
2"Instagram atendimento"
Obrigatório no modo UNOFFICIAL. Confirma ciência do risco de restrição pela plataforma.
true Connection type. UNOFFICIAL (default): Instagram login. OFFICIAL: Meta line. OFFICIAL_BYOK: your own Meta token and IDs.
UNOFFICIAL, OFFICIAL, OFFICIAL_BYOK Returns a link for someone else to finish Meta connection. Omit when sending credentials in this request.
Page Access Token (OFFICIAL_BYOK).
Facebook Page ID vinculada à conta IG (OFFICIAL_BYOK).
Instagram Business Account ID (OFFICIAL_BYOK).
App Secret Meta para validar webhooks (OFFICIAL_BYOK).
Código do Facebook Login (OFFICIAL). Alternativa: generateShareableLink=true.
Optional. Username esperado no login (conexão unofficial). Se o login conectar outra conta, a API responde 409 (INSTAGRAM_ACCOUNT_MISMATCH).
"seu_usuario"
"v1"
"pt-BR"
"America/Sao_Paulo"
Show child attributes
Show child attributes
Was this page helpful?

