Erro 40001 do TikTok: sem permissão para a operação
O erro 40001 do TikTok significa que quem faz a chamada não tem permissão para executar a operação solicitada. Na Accounts API, duas camadas decidem isso: o app de desenvolvedor precisa ter, em TikTok Accounts, a permissão que libera o endpoint, como Video Publish, e o token de acesso precisa conter os escopos que o dono da conta aprovou. Descubra em qual camada falta a permissão, adicione-a e faça a chamada de novo.
O easyCoexistence conecta uma conta do TikTok pelo próprio login do TikTok, em que você concede todas as permissões, para que Claude, ChatGPT ou o seu próprio código possam publicar, trabalhar com comentários e ler insights.
Código de retorno do TikTok quando quem faz a chamada não tem permissão para executar a operação solicitada.
ID de escopo de TikTok Accounts, a permissão de primeiro nível sob a qual ficam os endpoints da Accounts API.
Dias úteis que a análise do TikTok de uma mudança nas permissões de um app de desenvolvedor pode levar.
Desde então, um app novo ou um aumento de escopo que inclua TikTok Accounts precisa antes do Accounts API Access Application Form.
O que significa o erro 40001?
O TikTok recusou a chamada porque quem a fez não tem permissão para ela. O apêndice de códigos de retorno descreve o 40001 como falta de permissão para executar a operação relacionada, e a correção indicada é garantir que as permissões necessárias estejam configuradas antes de repetir a chamada. Ele remete à referência de escopos de permissão do TikTok, que lista os endpoints que cada permissão libera.
Qual permissão libera cada endpoint da Accounts API?
A referência de escopos de permissão do TikTok coloca a Accounts API sob a permissão de primeiro nível TikTok Accounts, ID de escopo 18000000, e indica abaixo dela a permissão de cada endpoint:
- Get Business User Basic Info: /business/get/, o perfil e os insights da conta.
- Business Media: /business/video/list/, as publicações da conta e suas métricas.
- Get Business Comment: /business/comment/list/ e /business/comment/reply/list/.
- Manage Business Comment: criar, responder, curtir, ocultar e excluir comentários.
- Video Publish: /business/video/publish/.
Como conferir os escopos de um token?
Pergunte ao próprio TikTok. O /tt_user/token_info/get/ recebe o ID do app e um token de acesso e retorna o escopo concedido pelo dono da conta, uma lista como user.info.basic, video.list, comment.list.manage e video.publish. A referência do TikTok para /business/get/ usa a mesma verificação nos campos que exigem permissão e, quando falta uma, a correção é pedir que o dono autorize o app de novo com ela.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
-H 'Content-Type: application/json' \
-d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'
# data.scope lists what the owner approved, for example
# "user.info.basic,video.list,comment.list.manage,video.publish"Como corrigir?
Descubra em qual camada falta a permissão. Se for no app de desenvolvedor, adicione-a em My Apps, no app, em Scope of permission, e aguarde a análise do TikTok; desde 20 de março de 2026, uma solicitação que adiciona TikTok Accounts também precisa do Accounts API Access Application Form. Se for no token, o dono da conta autoriza o app de novo e aprova o escopo. Aproveite para conferir se os IDs da chamada pertencem à conta indicada em business_id.
Erros comuns
- Adicionar uma permissão ao app e esperar que os tokens existentes passem a tê-la. Um token guarda os escopos que o dono aprovou, então o dono precisa autorizar o app de novo.
- Repetir a chamada com o mesmo app e o mesmo token. Nada muda na permissão que falta entre uma tentativa e outra, então a chamada é recusada de novo.
- Fazer upload de rascunhos com um token sem video.upload. A referência do TikTok exige essa permissão para upload_to_draft e orienta confirmá-la com /tt_user/token_info/get/.
- Solicitar campos de insights sem as permissões correspondentes. A referência do TikTok para /business/get/ indica uma permissão exigida por campo, e is_business_account precisa de user.account.type.
Se o TikTok ainda recusar uma chamada, a ferramenta devolve o código e a mensagem do TikTok, e reconectar a conta pelo painel executa a autorização do TikTok mais uma vez. De R$ 29,90 a R$ 3,90 por conexão por mês, caindo conforme você adiciona conexões, com os 3 primeiros dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
O que significa "no permission to perform the related operation" no TikTok?
É a descrição do TikTok para o código de retorno 40001: o app de desenvolvedor ou o token de acesso não tem a permissão que o endpoint exige.
Como vejo quais escopos um token de acesso do TikTok tem?
Chame /tt_user/token_info/get/ com o ID do seu app e o token. O campo scope lista cada permissão que o dono da conta concedeu.
A conta do TikTok precisa autorizar de novo depois que o app ganha uma permissão?
Sim, para que o token passe a ter o novo escopo. A orientação do TikTok é pedir que o dono da conta autorize o app de novo com essa permissão.
Quanto tempo o TikTok leva para aprovar novas permissões do app?
O TikTok diz que a análise de uma mudança de permissão pode levar de dois a três dias úteis, e o app existente é atualizado, não substituído.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em