Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 21/11/2025

Permissões funcionais

Ao criar um aplicativo, você deve configurar as permissões funcionais da sua integração. Elas serão necessárias para a autorização do usuário à sua aplicação, concedendo o Grant e permitindo o uso correto da nossa API em seu nome.

Nota:
Antes de criar um aplicativo, certifique-se de que a conta que você está usando é a conta do proprietário da solução que irá desenvolver, evitando assim problemas de transferência de conta no futuro. Recomendamos que a conta seja criada sob uma entidade legal.

Estas são as permissões disponíveis para configuração da sua integração:


Acesse nosso DevCenter.

Scopes

  • Somente leitura: permite o uso dos métodos API GET HTTPS.
  • Leitura e escrita: permite o uso dos métodos API PUT, POST e DELETE HTTPS.


Usuários (default)

Esta permissão está ativa por padrão em todos os aplicativos criados. Permite o consumo dos recursos de users, podendo obter as informações de uma conta registrada e autorizada do Mercado Livre.

Recursos relacionados

Publicação e sincronização

Esta é uma permissão que permite ao seu aplicativo criar, atualizar, pausar e/ou excluir uma ou todas as publicações da loja. Permite o acesso aos recursos de items, pictures, prices e outros.

Recursos relacionados

Comunicação pré e pós-venda

Permite ao seu aplicativo ler e enviar mensagens de pré e pós-compra.

Permite o acesso aos recursos de questions, messages, claims e returns.

Recursos relacionados

Publicidade

Esta é uma permissão que permite ao seu aplicativo acessar, criar e gerenciar campanhas de publicidade.

Permite o acesso aos recursos de Advertising.

Recursos relacionados

Métricas do negócio

Esta é uma permissão que permite ao seu aplicativo acompanhar as métricas e indicadores sobre vendas, estoque e reputação, assim como informações fiscais, balanços e relatórios de operações.

Permite o acesso aos recursos de trends, highlights, visits e outros.

Recursos relacionados

Vendas e envios

Esta é uma permissão que permite ao seu aplicativo gerenciar vendas e envios, como despachos, devoluções, estornos e reclamações.

Permite o acesso aos recursos de orders, shipments, claims e returns.

Recursos relacionados

Promoções, cupons e descontos

Esta é uma permissão que permite ao seu aplicativo acessar, criar e gerenciar ofertas e cupons.

Permite o acesso aos recursos de offers e deals.

Recursos relacionados

Faturamento

Esta é uma permissão que permite ao seu aplicativo enviar faturas e gerenciar detalhes de faturamento, além de monitorar os recebimentos, movimentos, saldos da conta e todos os relatórios de faturamento.

Permite o acesso aos recursos de invoices, billing e outros.

Recursos relacionados


Erro por falta de Permissão

O segunte erro é retornado caso sua integração não tenha acesso ao recurso por falta da Permissão funcional correspondente:

Resposta:

{
"code": "PA_UNAUTHORIZED_RESULT_FROM_POLICIES",
"blocked_by": "PolicyAgent",
"message": "At least one policy returned UNAUTHORIZED.",
"status": 403
}

Para solucionar você deverá acesar as configurações de sua aplicação e habilitar a Permissão funcional associada, ativando os escopos de leitura e escritura.