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 pedida. Na API Accounts, duas camadas determinam isso: a aplicação de programador tem de ter a permissão em TikTok Accounts que abre o endpoint, como Video Publish, e o token de acesso tem de incluir os scopes que o titular da conta aprovou. Encontre a camada em falta, adicione a permissão e volte a fazer a chamada.
O easyCoexistence liga uma conta do TikTok através do próprio início de sessão do TikTok, onde concede todas as permissões, para que o Claude, o 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 pedida.
ID de scope de TikTok Accounts, a permissão de primeiro nível sob a qual estão os endpoints da API Accounts.
Dias úteis que a análise do TikTok a uma alteração das permissões de uma aplicação de programador pode demorar.
Desde então, uma nova aplicação ou um aumento de scopes que inclua TikTok Accounts precisa primeiro do Formulário de Pedido de Acesso à API Accounts.
O que significa o erro 40001?
O TikTok recusou a chamada porque quem a faz não tem permissão para a executar. O anexo dos códigos de retorno indica o 40001 como falta de permissão para executar a operação relacionada, e a correção é garantir que as permissões necessárias estão atribuídas antes de voltar a tentar. Remete para a referência de scopes de permissão, que lista os endpoints que cada permissão abre.
Que permissão abre cada endpoint da API Accounts?
A referência de scopes de permissão do TikTok coloca a API Accounts sob a permissão de primeiro nível TikTok Accounts, com o ID de scope 18000000, e indica a permissão abaixo dela para 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 as respetivas métricas.
- Get Business Comment: /business/comment/list/ e /business/comment/reply/list/.
- Manage Business Comment: criar, responder, marcar gosto, ocultar e eliminar comentários.
- Video Publish: /business/video/publish/.
Como se verificam os scopes de um token?
Pergunte ao TikTok. /tt_user/token_info/get/ recebe o ID da aplicação e um token de acesso e devolve o scope que o titular da conta concedeu, 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 para os campos que exigem uma permissão e, quando falta uma, a correção é pedir ao titular que volte a autorizar a aplicação 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 se corrige?
Descubra qual das camadas está em falta. Se a aplicação de programador não tiver a permissão, adicione-a em My Apps, na aplicação, em Scope of permission, e aguarde a análise do TikTok; desde 20 de março de 2026, um pedido que acrescente TikTok Accounts precisa também do Formulário de Pedido de Acesso à API Accounts. Se o token não tiver o scope, o titular da conta volta a autorizar a aplicação e a aprovar. Já agora, confirme que os IDs da chamada pertencem à conta indicada em business_id.
Erros comuns
- Adicionar uma permissão à aplicação e esperar que os tokens existentes a incluam. Um token tem os scopes que o titular aprovou, por isso o titular tem de voltar a autorizar a aplicação.
- Voltar a tentar com a mesma aplicação e o mesmo token. Nada na permissão em falta muda entre tentativas, por isso a chamada volta a ser recusada.
- Carregar rascunhos com um token que não tem video.upload. A referência do TikTok indica essa permissão para upload_to_draft e pede que se confirme com /tt_user/token_info/get/.
- Pedir campos de insights sem as respetivas permissões. A referência do TikTok para /business/get/ indica uma permissão necessária por campo, e is_business_account exige user.account.type.
Quando o TikTok continuar a recusar uma chamada, a ferramenta devolve o código e a mensagem do TikTok, e voltar a ligar a conta a partir do painel executa mais uma vez a autorização do TikTok. Custa de US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias gratuitos.
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: a aplicação de programador ou o token de acesso não tem a permissão que o endpoint exige.
Como vejo que scopes tem um token de acesso do TikTok?
Chame /tt_user/token_info/get/ com o ID da sua aplicação e o token. O campo scope lista todas as permissões que o titular da conta concedeu.
A conta do TikTok precisa de voltar a autorizar depois de a aplicação ganhar uma permissão?
Sim, para que o token inclua o novo scope. A orientação do TikTok é que o titular da conta volte a autorizar a aplicação com essa permissão.
Quanto tempo demora o TikTok a aprovar novas permissões da aplicação?
O TikTok diz que a análise de uma alteração de permissões pode levar dois a três dias úteis, e a aplicação existente é atualizada, não substituída.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em