Error 40001 de TikTok: sin permiso para la operación
El error 40001 de TikTok significa que quien hace la llamada no tiene permiso para realizar la operación solicitada. En la API de Accounts lo deciden dos capas: la app de desarrollador debe tener, dentro de TikTok Accounts, el permiso que da acceso al endpoint, como Video Publish, y el token de acceso debe incluir los scopes que aprobó el propietario de la cuenta. Identifica la capa que falla, añade el permiso y vuelve a hacer la llamada.
easyCoexistence conecta una cuenta de TikTok mediante el inicio de sesión del propio TikTok, donde concedes cada permiso, para que Claude, ChatGPT o tu propio código puedan publicar, gestionar comentarios y leer estadísticas.
Código de respuesta de TikTok cuando quien hace la llamada no tiene permiso para realizar la operación solicitada.
ID del scope de TikTok Accounts, el permiso de primer nivel del que dependen los endpoints de la API de Accounts.
Días hábiles que puede tardar TikTok en revisar un cambio en los permisos de una app de desarrollador.
Desde entonces, una app nueva o una ampliación de scopes que incluya TikTok Accounts necesita primero el Formulario de solicitud de acceso a la API de Accounts.
¿Qué significa el error 40001?
TikTok rechazó la llamada porque quien la hace no tiene permiso para ella. El apéndice de códigos de respuesta define el 40001 como falta de permiso para realizar la operación relacionada, y la solución que indica es asegurarse de contar con los permisos necesarios antes de reintentar. Remite a la referencia de scopes de permisos de TikTok, que enumera los endpoints a los que da acceso cada permiso.
¿Qué permiso da acceso a cada endpoint de la API de Accounts?
La referencia de scopes de permisos de TikTok sitúa la API de Accounts bajo el permiso de primer nivel TikTok Accounts, con scope ID 18000000, e indica qué permiso de segundo nivel corresponde a cada endpoint:
- Get Business User Basic Info: /business/get/, el perfil y las estadísticas de la cuenta.
- Business Media: /business/video/list/, las publicaciones de la cuenta y sus métricas.
- Get Business Comment: /business/comment/list/ y /business/comment/reply/list/.
- Manage Business Comment: crear, responder, dar me gusta, ocultar y eliminar comentarios.
- Video Publish: /business/video/publish/.
¿Cómo se revisan los scopes de un token?
Preguntándoselo a TikTok. /tt_user/token_info/get/ recibe el ID de la app y un token de acceso, y devuelve el scope que otorgó el propietario de la cuenta, una lista como user.info.basic, video.list, comment.list.manage y video.publish. La referencia de TikTok para /business/get/ usa la misma comprobación para los campos que requieren un permiso y, cuando falta uno, la solución que indica es que el propietario vuelva a autorizar la app con ese permiso.
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"¿Cómo se soluciona?
Averigua qué capa es la que falla. Si a la app de desarrollador le falta el permiso, añádelo en My Apps, la app, Scope of permission, y espera la revisión de TikTok; desde el 20 de marzo de 2026, una solicitud que añada TikTok Accounts también necesita el Formulario de solicitud de acceso a la API de Accounts. Si al token le falta el scope, el propietario de la cuenta vuelve a autorizar la app y lo aprueba. De paso, comprueba que los IDs de la llamada pertenezcan a la cuenta indicada en business_id.
Errores comunes
- Añadir un permiso a la app y esperar que los tokens existentes lo incluyan. Un token solo tiene los scopes que aprobó el propietario, así que el propietario tiene que volver a autorizar la app.
- Reintentar con la misma app y el mismo token. El permiso que falta no cambia de un intento a otro, así que la llamada vuelve a ser rechazada.
- Subir borradores con un token que no tiene video.upload. La referencia de TikTok indica ese permiso para upload_to_draft y recomienda confirmarlo con /tt_user/token_info/get/.
- Pedir campos de estadísticas sin sus permisos. La referencia de TikTok para /business/get/ indica un permiso requerido por campo, y is_business_account necesita user.account.type.
Si aun así TikTok rechaza una llamada, la herramienta devuelve el código y el mensaje de TikTok, y al volver a conectar la cuenta desde el panel se ejecuta de nuevo la autorización de TikTok. De US$ 9 a US$ 0.75 por conexión al mes, un precio que baja a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Qué significa «no permission to perform the related operation» en TikTok?
Es la descripción que da TikTok del código de respuesta 40001: la app de desarrollador o el token de acceso no tienen el permiso que requiere el endpoint.
¿Cómo veo qué scopes tiene un token de acceso de TikTok?
Llama a /tt_user/token_info/get/ con el ID de tu app y el token. Su campo scope enumera todos los permisos que otorgó el propietario de la cuenta.
¿Una cuenta de TikTok tiene que volver a autorizar la app cuando esta obtiene un nuevo permiso?
Sí, para que su token incluya el nuevo scope. TikTok recomienda que el propietario de la cuenta vuelva a autorizar la app con ese permiso.
¿Cuánto tarda TikTok en aprobar nuevos permisos para una app?
TikTok indica que la revisión de un cambio de permisos puede tardar de dos a tres días hábiles, y que la app existente se actualiza en lugar de sustituirse.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el