For AI agents: the complete documentation index is available at https://docs.clickmax.io/en/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/en/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/en/reference/error-codes.md.
  • English

      • Error codes and messages

      Every Clickmax error combines an HTTP code (the family of the problem) with a message (the exact reason). The table below translates the most common codes and lists the messages you are most likely to see, with what to do in each case.

      Before you start. Permission errors (403) depend on your role in the workspace. The roles are owner, admin, editor, viewer, finance_only, guest and attendant. Restricted roles — guest and attendant (except an attendant with the coordenador sub-role) — cannot change lists or segments or export contacts, even though they can read them. See roles and permissions.

      HTTP codes

      CodeMeaningWhat to do
      400Invalid data in the requestFix the field named in the message and try again
      401Not authenticated / session expiredLog in again
      402Feature not included in the plan, or credits exhaustedSee plan limits
      403No permission for the actionAsk an owner/admin, or see roles and permissions
      404Record not foundThe item was deleted or the link is wrong
      409Conflict (duplicate item, already exists, or changed by someone else)Reload the screen and try again
      413File too largeSee upload limits
      415Unsupported file formatSend an accepted format
      422The data could not be processedReview the data you sent
      429Too many requestsWait a minute and try again
      500Internal Clickmax errorTry later; if it persists, contact support
      502External service failureA third-party service is unstable; try again
      503Service temporarily unavailableTry again in a moment

      Permission messages (403)

      MessageReason
      Você não tem permissão para executar esta açãoYour role in the workspace does not allow this action
      Você não tem acesso a importação de FunisYour role is restricted from importing funnels
      Este atendente não está autorizado a atender este canal.The attendant is not assigned to the channel

      The guest and attendant roles get a 403 with no message when they try to edit lists or segments or export contacts. See when permission does not appear.

      Validation messages (400)

      MessageAreaWhat to do
      Etapa inválida: não pertence ao pipeline informado.OpportunitiesChoose a stage from the correct pipeline
      lossReason é obrigatório para marcar como perdidaOpportunitiesGive the loss reason — see lost opportunity
      A comissão total dos coprodutores não pode ultrapassar 80%ProductsReduce the commissions — see coproduction commissions
      Ofertas de assinatura não podem ser de produtos físicos.ProductsUse a digital product for the subscription
      A data inicial não pode ser maior que a data final.ReportsAdjust the date range
      Número de WhatsApp inválidoMessagesCheck the number when connecting WhatsApp
      Remetente de e-mail inválidoMessagesCheck the sender when setting up the email domain
      Cliente não possui gateways válidosPaymentsFinish the seller registration
      O conteúdo da publicação contém um link não permitidoMembers areaRemove the blocked link from the post
      O conteúdo da publicação excede o tamanho máximo permitidoMembers areaShorten the post

      Plan and limit messages (402)

      SituationWhat to do
      A plan feature (templates, quizzes, credits) is blockedSee plan limits
      Members area limit reachedSee members area limit
      Contact limit reachedSee contact limit
      Meta has limited your WhatsApp sendsSee Meta's limit

      If it didn't work